I keep getting a sign-in or auth error. What's wrong?
I keep getting a sign-in or auth error. What's wrong?
The most common cause is that the MCP hasn’t been enabled in your Within workspace yet. Both OAuth and API-key auth require this one-time setup:
- Log in to Within in a browser.
- Go to Settings → MCP.
- Pick the workspace you want to expose and complete the in-app setup.
My organization doesn't have Within yet. Can I use this?
My organization doesn't have Within yet. Can I use this?
Not directly. Within is a commercial service — you need an active workspace and a provisioned user account to use the MCP. Contact hello@within.ai to talk about access.
The connector says my org hasn't approved it.
The connector says my org hasn't approved it.
Your organization’s Within workspace admin needs to approve the Within connector (Claude) or app (ChatGPT) before users can sign in. Ask your admin, or have them reach out to hello@within.ai.
How do I switch between Within workspaces?
How do I switch between Within workspaces?
A connection is scoped to one workspace, so you switch at the auth level rather than from inside the assistant. How you do it depends on your authentication method:
- OAuth: disconnect the Within connection in your client and reconnect. The reconnect flow shows a workspace picker.
- API key: keys are bound to the workspace they were generated in. Generate a new key in the other workspace and swap the Bearer token in your client.
How do I rotate or revoke an API key?
How do I rotate or revoke an API key?
Go to Settings → MCP in your Within workspace. You can view, disable, or rotate existing keys from the same screen where you generated them.If you suspect a key has been exposed, revoke it immediately, generate a new one, and update your client configuration. See Authentication → Keep keys safe.
How do I confirm the MCP is connected?
How do I confirm the MCP is connected?
In your AI client, ask something like:If the assistant calls the
search tool and returns processes from your workspace, you’re connected. If it falls back to generic answers or says it has no access to Within, the install hasn’t completed — re-check the install steps for your client.Can I create or edit processes through the MCP?
Can I create or edit processes through the MCP?
No. All process, artifact, and graph edits happen in the Within UI. The optional
submit_feedback tool writes user-approved feedback to Within analytics. See Limitations.The assistant says 'no evidence found in the workspace.' Is something broken?
The assistant says 'no evidence found in the workspace.' Is something broken?
Usually not. That response means the workspace doesn’t yet have captured data covering the question — typically a capture gap, not an MCP bug. The gap itself is useful: it tells you what to capture next.If the question should have evidence and the assistant can’t find it, try refining the query — single searches miss, and processes use organization-specific names. See Operating principles.
Which client should I use?
Which client should I use?
Any MCP-compatible client works. Use the install page that matches what you have today:
- Claude
- Claude Code
- ChatGPT
- Codex
- Cursor
- Gemini CLI
- GitHub Copilot
- Microsoft Copilot (custom Copilot Studio agent)
Where do I get the Agent Development Kit?
Where do I get the Agent Development Kit?
A workspace admin downloads it from Settings → Downloads in Within. If you can’t see the Downloads tab, ask your workspace admin for the kit. See Download and install.
Does the ADK need its own sign-in?
Does the ADK need its own sign-in?
No. The ADK uses your client’s Within MCP connection. Connect Within in that client first; see Quickstart.
Which clients run the ADK?
Which clients run the ADK?
Claude Code and Codex run all four modules. Cowork runs Agent Recommendations, Future State Design, and Agent Design; use Claude Code or Codex for Agent Build.