Skip to main content
You need an active Within workspace and a user account. If you’re not sure whether your organization has one, contact hello@within.ai.
1

Pick your client

Within MCP works with any MCP-compatible client. Use the install page that matches yours.

Claude

Anthropic assistant

Claude Code

Anthropic CLI

ChatGPT

OpenAI assistant

Codex

OpenAI CLI

Cursor

IDE

Gemini CLI

Google CLI

GitHub Copilot

GitHub CLI and app
2

Authenticate

Two methods are supported:
  • OAuth — preferred where the client supports it. Sign in to Within from the client; no key handling.
  • API key — used in alpha clients and as a fallback. Generate a key from Settings → MCP in your Within workspace and pass it as a Bearer token.
See Authentication for the full setup.
3

Ask your first question

Start with something concrete from your workspace. The MCP is most useful when the question references your processes, systems, or teams.Examples:
  • “How does our vendor onboarding process work today?”
  • “What changed in our month-end close in the last 30 days?”
  • “Which processes depend on System X?”
  • “Find the highest-leverage automation opportunities in our P2P value stream.”
See How-to guides for end-to-end recipes.

​
What to expect

The first time the assistant calls a Within tool, it will prompt you to authenticate (OAuth) or read your configured API key. After that, the assistant chains MCP tools in the background — searching the Process Index, fetching specific processes, pulling observations, and drilling into the activity timelines behind those observations — and answers in business language, citing the workspace evidence behind each claim. If the assistant cannot find evidence for a claim in your workspace, it should say so plainly. That gap is itself useful information.

​
Next steps

Read the concepts

The Discover → Structure → Improve loop, and the three intelligence layers.

Browse the tools

Every tool the MCP exposes, with selection guidance.