MCP Quickstart

Connect Claude Desktop, Cursor, VS Code, or any MCP-compatible client to your ClawCentral agent. Once connected, you can chat with your agent, manage sessions, configure skills, and schedule tasks — all from your IDE.

For protocol details, custom client integration, and the full tool reference, see MCP Server — Protocol & Integration.

Prerequisites

• A ClawCentral account (sign up)
• A tenant with an AI provider configured (see Getting Started)
• An MCP-compatible client (Claude Desktop, Cursor, VS Code, Windsurf, Goose, etc.)

Your MCP endpoint

Every ClawCentral tenant exposes an MCP server at:

https://<your-slug>.clawcentral.io/mcp

Replace <your-slug> with your tenant's subdomain slug. You can find this in the URL when you open your admin panel.

Connect your IDE

Claude Desktop

1. Open Claude Desktop settings (gear icon or Cmd+,)
2. Navigate to Developer -> Edit Config
3. Add your ClawCentral server to the mcpServers section:

{
  "mcpServers": {
    "clawcentral": {
      "url": "https://<your-slug>.clawcentral.io/mcp"
    }
  }
}

4. Save and restart Claude Desktop
5. When prompted, authorize in your browser — you'll sign in with the same account you use for ClawCentral

Cursor

1. Open Cursor settings (Cmd+, or Ctrl+,)
2. Search for MCP in the settings search bar
3. Click Add new MCP server
4. Enter:
   • Name: clawcentral
   • Type: sse
   • URL: https://<your-slug>.clawcentral.io/mcp
5. Save and authorize when your browser opens

Alternatively, create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "clawcentral": {
      "url": "https://<your-slug>.clawcentral.io/mcp"
    }
  }
}

VS Code

1. Create or edit .vscode/mcp.json in your project:

{
  "servers": {
    "clawcentral": {
      "url": "https://<your-slug>.clawcentral.io/mcp"
    }
  }
}

2. Reload VS Code
3. Authorize in your browser when prompted

Claude Code

Add the server directly from the CLI:

claude mcp add clawcentral --transport http https://<your-slug>.clawcentral.io/mcp

Windsurf

Create .windsurf/mcp.json in your project:

{
  "mcpServers": {
    "clawcentral": {
      "url": "https://<your-slug>.clawcentral.io/mcp"
    }
  }
}

Authentication

ClawCentral uses OAuth 2.1 for MCP connections. When your IDE first connects:

1. Your browser opens to ClawCentral's sign-in page
2. Sign in with your ClawCentral account (same as the admin panel)
3. The IDE receives an access token automatically
4. The token refreshes in the background — you won't need to re-authorize unless you revoke access

No API keys or manual token management needed.

Verify the connection

After setup, test the connection by asking your IDE to use a ClawCentral tool. For example:

• In Claude Desktop: ask "What's my system status?" — the agent should call the status tool
• In Cursor/VS Code: use the MCP tool picker to invoke status or chat_send

If the tool returns data, your connection is working.

Available tools

Your ClawCentral MCP server exposes 30 tools organized by category:

Category	Tools	What you can do
Chat	chat_send, chat_history, chat_abort	Send messages, view history, stop responses
Async Chat	chat_send_async, chat_run_get, chat_run_list, chat_run_cancel	Send long-running messages without blocking
Sessions	sessions_list, sessions_get, sessions_patch, sessions_delete, sessions_usage	Manage conversation sessions and view token usage
Config	config_get, config_set	Read and update agent configuration
Models	models_list	See available AI models
Skills	skills_list, skills_browse, skills_install, skills_registries	Browse and install agent skills
Agents	agents_list	List configured agents
Channels	channels_status, channels_action, channels_history	Monitor and interact with messaging channels
Cron	cron_list, cron_add, cron_remove, cron_run, cron_runs	Schedule and manage recurring tasks
System	status, usage_cost	Check health and view usage/cost breakdown

For long responses

Use chat_send_async instead of chat_send for messages that may take a while. It returns a runId immediately — poll with chat_run_get to stream results as they arrive.

Troubleshooting

"Authorization failed" or browser doesn't open

• Ensure your tenant slug is correct in the URL
• Check that you're signed in to the same ClawCentral account that has access to the tenant
• Try opening https://<your-slug>.clawcentral.io/mcp/health in your browser — it should return {"ok":true}

Tools aren't showing up

• Restart your IDE after adding the config
• Check the MCP server logs in your IDE's developer console
• Verify your AI provider is configured in the tenant admin panel (tools require a working agent)

Slow or timing out

• Use chat_send_async for long conversations — synchronous chat_send may time out on complex responses
• Check your AI provider's rate limits in the tenant Usage tab

Next steps

• Getting Started — full setup walkthrough including AI provider and channels
• MCP Servers catalog — browse and install third-party MCP servers in your admin panel
• Configure your agent's personality and skills in the admin panel at https://<your-slug>.clawcentral.io/