Client support

Last updated Jun 14, 2026

The Matter MCP server speaks Streamable HTTP and is hosted at https://mcp.mattermode.com. Every supported client points at the same server — install snippets differ only in where the client stores tokens and config.

For the minimal install command for each, see installation. This page collects the per-client details and any gotchas.

Claude Code

The first-class integration. OAuth 2.1 handled via the interactive prompt.

claude mcp add --transport http matter https://mcp.mattermode.com

Tools appear in the Claude Code tool picker. Tier filtering surfaces what the signed-in user's token permits.

Claude Desktop

{
  "mcpServers": {
    "matter": {
      "url": "https://mcp.mattermode.com",
      "transport": "streamable-http",
      "auth": { "type": "oauth2" }
    }
  }
}

Path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows).

Cursor / Windsurf

{
  "mcpServers": {
    "matter": {
      "url": "https://mcp.mattermode.com",
      "transport": "streamable-http",
      "headers": { "Authorization": "Bearer ${MATTER_KEY}" }
    }
  }
}

Cursor: ~/.cursor/mcp.json. Windsurf: ~/.codeium/windsurf/mcp_config.json. Both read environment variables via the ${VAR} syntax — keep the actual secret out of the file.

Zed

{
  "context_servers": {
    "matter": {
      "command": {
        "path": "npx",
        "args": ["@modelcontextprotocol/inspector", "http", "https://mcp.mattermode.com"]
      },
      "env": { "MATTER_KEY": "sk_test_matter_example_..." }
    }
  }
}

Codex

codex --mcp https://mcp.mattermode.com --mcp-header "Authorization: Bearer $MATTER_KEY"

The Codex CLI accepts --mcp-header multiple times — add Matter-Version: 2026-05-01 if you want to pin to a specific API version across the session.

Gemini CLI

gemini mcp add matter \
  --transport http \
  --url https://mcp.mattermode.com \
  --header "Authorization: Bearer $MATTER_KEY" \
  --header "Matter-Version: 2026-05-01"

MCP Inspector

The reference debugger for MCP servers. Great for verifying tool visibility, inspecting input schemas, and walking through call_tool payloads:

npx @modelcontextprotocol/inspector http https://mcp.mattermode.com

Use it to verify a token's tier filter is behaving correctly — connect with different sk_test_ and tok_ tokens and compare the list_tools response.

Local / self-hosted

For air-gapped or corporate environments, run the MCP server locally:

cd apps/mcp
bun install
bun run generate-tools
bun run dev

Then point any client above at http://localhost:3200. The local server hits https://api.mattermode.com/v1 by default; set MATTER_API_BASE_URL=https://api-staging.mattermode.com/v1 to target a staging environment.

Telemetry

Clients should send User-Agent: <client-name>/<version> on every request. Matter uses this for operational metrics and to detect client-specific bugs. No PII is logged.