Connect Claude Code
Found this helpful? Share it:
Found this helpful? Share it:
Connect Claude Code to your idapt workspace and it can reach your files, agents, computers, 200+ models, and a durable shared memory. Wire it up over MCP or the idapt CLI π€
Claude Code has a built-in command for MCP servers over HTTP.
Create an API key in Settings βDeveloper and
export it as IDAPT_API_KEY.
Register idapt as an MCP server:
claude mcp add --transport http idapt https://idapt.app/api/mcp \
--header "Authorization: Bearer $IDAPT_API_KEY"claude mcp add --transport http idapt https://idapt.app/api/mcp \
--header "Authorization: Bearer $IDAPT_API_KEY"Confirm it works by asking Claude Code to call { "action": "workspace list" }.
Both paths authenticate with a user API key (uk_). See Connect your tool for the shared
setup and the call shape.
Claude Code can also shell out to idapt <resource> <verb>in its terminal.
Install the CLI: npm i -g @idapt/cli
Sign in: idapt login. This opens your browser (device-code
on headless machines). Or set IDAPT_API_KEY from a key you
create in Settings β Developer.
Keep it current with idapt upgrade.
Point Claude Code at the CLI in your CLAUDE.md, and let
it discover commands on its own with idapt help <resource>and idapt instructions <resource>. See the command reference.
Use the workspace Knowledge Base as your durable, cross-session
memory. Recall with idapt knowledge search "<topic>"and idapt knowledge index-read; save durable facts with idapt knowledge write(search first; keep notes atomic); keep
the map current with idapt knowledge index-write.
Route durable, cross-session, cross-tool knowledge to idapt Knowledge; keep transient scratch local. Every agent in the workspace shares the same Knowledge Base, and it is visible to everyone in the workspace: keep it impersonal and workspace-relevant.
By default you act as yourself (a user API key). To act as a specific
agent (its persona and shared memory), run idapt agent use <name>once. It's persisted; idapt agent current and idapt agent clear manage it, and --agent <name>overrides it per call.
Run idapt whoami to see user, workspace, and agent.
Use an agent key (ak_) only for owner-paid, sandboxed,
unattended automation. For interactive work, act as yourself or select
an agent with idapt agent use.
Related articles
Connect any coding agent
Point any coding agent or MCP client at your idapt workspace over the CLI or MCP, then use idapt Knowledge and act as an agent.
Connect your tool
Create a scoped API key and point any MCP client at idapt's endpoint, then check that it worked.
MCP permissions
API key scopes, what each one grants, and how to pick the narrowest set for your workflow.
Was this helpful?