Coreby Gradien

Agent guide

Claude Code Setup

Back to setup docsRaw source

Paste this into your agent

Start with this visible request when you want the agent to help. It keeps the action coming from you, while the linked setup reference stays plain and non-recursive.

Use this in the app you are connecting, then approve only the browser login, app setting, or restart steps that the app requires.

Please help me set up Core for Claude Code. Core is a home base for AI agents: it keeps memory, files, decisions, tasks, and work context synced across tools, harnesses, and models.

Use this official setup reference:
https://gradien.ai/core/docs/reference

Claude Code can add remote MCP servers from the command line and complete OAuth through the app's MCP UI.

Claude Code is different from Claude Desktop. Use this page only for Claude Code.

Run the guided installer:

npx -y @gradien/core-agent-setup install --base-url https://core.gradien.ai --yes --harness claude-code

The installer creates a short-lived Core signup/login session, registers Core for Claude Code, and prints any agent-specific next steps.

Core MCP server URL:

https://core.gradien.ai/mcp

Authentication

Claude Code may not show a newly added MCP server inside /mcp until the app restarts.

Use this order:

  1. Finish the installer.
  2. Fully quit and reopen Claude Code, or start a fresh Claude Code session.
  3. Run /mcp.
  4. Select Core.
  5. Choose Authenticate or Connect if prompted.
  6. Approve Core in the browser.

If Core is missing from /mcp before a restart, treat that as a stale Claude Code session rather than a failed install.

Verify

After authentication, Core should appear as a connected MCP server and expose Core tools in a fresh Claude Code session. If tools are still missing, restart Claude Code once more before reinstalling.