Claude Code

Claude Code supports MCP servers via a .mcp.json configuration file.

Configuration

Save the following as .mcp.json in your project root:

{
  "mcpServers": {
    "maestrohub": {
      "type": "http",
      "url": "https://<your-instance>/api/v1/mcp",
      "headers": {
        "Authorization": "ApiKey <your-token>",
        "X-Organization-ID": "<your-org-id>"
      }
    }
  }
}

Replace the placeholders:

• <your-instance> — your MaestroHub domain (e.g., maestro.example.com)
• <your-token> — the Personal Access Token you created
• <your-org-id> — your organization ID (found in the URL or organization settings)

note

For local deployments without TLS, change https:// to http:// in the URL (e.g., http://localhost:8080/api/v1/mcp).

Tips

• Claude Code picks up .mcp.json automatically when you open the project — no restart needed.
• You can also place the config in ~/.claude/mcp.json for global access across all projects.
• Add .mcp.json to your .gitignore to avoid committing tokens.