Connect to Claude Desktop

Prerequisites

• Claude Desktop installed (macOS or Windows)
• A deployed Micipi server with a gateway URL
• Your Micipi API key (found on the Gateway page)

Step 1: Open the config file

Claude Desktop stores MCP server configuration in a JSON file. Open it with:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

notepad %APPDATA%\Claude\claude_desktop_config.json

If the file does not exist, create it with an empty JSON object: {}

Step 2: Add your server

Add your Micipi server to the mcpServers section. Replace the URL and API key with your own:

{
  "mcpServers": {
    "my-micipi-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://gateway.micipi.com/s/your-server-name",
        "--header",
        "Authorization:${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "Bearer mcp_your_api_key_here"
      }
    }
  }
}

Step 3: Restart Claude Desktop

Quit and reopen Claude Desktop. Your server will appear in the tools menu (hammer icon) at the bottom of the chat input.

You can now ask Claude to use your tools by name, or simply describe what you want and Claude will discover the right tool automatically.

Troubleshooting