Claude Code
Use Claude Code’s terminal-enabled agent to prepare Ark for you. This guide is for the coding client, not Claude Desktop.
Recommended Setup
Section titled “Recommended Setup”- Send the guided setup request to Claude Code, naming Claude Code as the target.
- Approve setup changes and enter provider keys in the private editor.
- Open
/mcp, review the connection and enableark-seed.
Claude Code starts the server automatically. You do not need to run the registration command below yourself if your setup agent has completed it.
Manual configuration and scope options
Choose the Scope
Section titled “Choose the Scope”| CLI scope | Visibility | Storage |
|---|---|---|
user |
All your projects; recommended default | User configuration, normally ~/.claude.json |
local |
Private to the current project | Project-specific entry in user configuration |
project |
Shareable configuration for this project | Project-root .mcp.json |
Claude Code’s default local scope is not global. CLAUDE_CONFIG_DIR
can change user configuration locations; prefer the CLI over editing that
file manually. For either project scope, run registration from the intended
project, which need not be the Ark checkout.
Register
Section titled “Register”Complete the shared prerequisites. Check
claude mcp add --help for the installed CLI before using these Bash/POSIX
commands. The variables contain only absolute paths, never credential values:
UV="/absolute/path/to/uv"CHECKOUT="/absolute/path/to/ark-mcp"ENV_FILE="/absolute/path/to/private/ark-mcp/.env"
claude mcp add ark-seed --transport stdio --scope user \ --env "ARK_MCP_ENV_FILE=$ENV_FILE" \ --env MCP_TRANSPORT=stdio \ --env MCP_AUTH_MODE=local \ -- "$UV" --directory "$CHECKOUT" run --locked --no-sync python -m ark_mcpPut the server name before --env, since that option may consume multiple
values. -- separates Claude’s options from the server command.
Replace --scope user with --scope local for a private project entry, or
--scope project for the shareable file. Do not blindly re-add or remove an
existing ark-seed entry to resolve shadowing.
For manual project configuration, merge this entry into .mcp.json:
{ "mcpServers": { "ark-seed": { "type": "stdio", "command": "/absolute/path/to/uv", "args": [ "--directory", "/absolute/path/to/ark-mcp", "run", "--locked", "--no-sync", "python", "-m", "ark_mcp" ], "env": { "ARK_MCP_ENV_FILE": "/absolute/path/to/private/ark-mcp/.env", "MCP_TRANSPORT": "stdio", "MCP_AUTH_MODE": "local" } } }}These machine-specific paths are not portable team defaults. Each teammate needs their own private env file and installation. Do not commit populated credential files or automatically commit this configuration.
Verify
Section titled “Verify”Use the discovery-only check, then try
Your First Tool Call. Confirm actual tool results,
not just an entry in /mcp. Finish active jobs before restarting the connection.
See Integrations, Getting Started, Tools, and Configuration.
Official Source
Section titled “Official Source”Source consulted 2026-11-10. Check local help and the installed edition before registration.