Claude Code

Claude Code is Anthropic’s CLI for Claude. It supports MCP servers, letting you use Toolcog directly from the command line.

Prerequisites

Add Toolcog

Use the Claude Code CLI to add the Toolcog MCP server:

Terminal window
claude mcp add toolcog --transport http --scope user -- https://mcp.toolcog.com

This adds Toolcog at user scope, making it available across all your projects.

Scope Options

MCP servers can be configured at three scope levels:

ScopeUse CaseLocation
userAvailable everywhere~/.claude/settings.local.json
projectShared with team.mcp.json in project root
localProject-specific, not shared.claude/settings.local.json in project

For most users, user scope is appropriate:

Terminal window
claude mcp add toolcog --transport http --scope user -- https://mcp.toolcog.com

For team-shared access to a custom catalog:

Terminal window
claude mcp add toolcog --transport http --scope project -- https://mcp.toolcog.com/mycompany/shared-catalog

Verify Installation

List configured MCP servers:

Terminal window
claude mcp list

You should see toolcog in the output.

Test the connection:

Terminal window
claude mcp get toolcog

Using Toolcog

Start a Claude Code session and ask for API operations:

Terminal window
claude

Then in the session:

“Find Stripe operations for creating invoices”

Claude will use Toolcog to discover operations, show you their interfaces, and execute them when you ask.

Authentication

When Claude needs to access your Toolcog account:

  1. Claude displays an authorization link
  2. Open the link in your browser
  3. Sign in to Toolcog
  4. Return to Claude Code

Your session persists until it expires.

Catalogs

Connect to a specific catalog:

Terminal window
claude mcp add toolcog-internal --transport http --scope user -- https://mcp.toolcog.com/mycompany/internal-apis

You can have multiple Toolcog connections with different scopes.

Remove Toolcog

Terminal window
claude mcp remove toolcog

Troubleshooting

Server not connecting

Verify the server is configured:

Terminal window
claude mcp list

If not listed, re-add it with the correct transport:

Terminal window
claude mcp add toolcog --transport http --scope user -- https://mcp.toolcog.com

Permission errors

Ensure you’re authenticated with Toolcog. If prompted, click the authorization link to sign in.

Windows users

On native Windows (not WSL), some MCP configurations may require the cmd /c wrapper. For Toolcog’s HTTP transport, this typically isn’t needed.

Direct Configuration

If you prefer editing config files directly, add to ~/.claude/settings.local.json:

{
  "mcpServers": {
    "toolcog": {
      "transport": "http",
      "url": "https://mcp.toolcog.com"
    }
  }
}

Next Steps