Skip to main content

Connect your AI tools

Sophic ships an MCP server, so any MCP-capable tool can search and read your workspace knowledge base. The dashboard generates ready-to-paste config for the most common tools under Settings → Integrations — this page documents the same snippets.

Every tool uses one of two transports:

  • Hosted (paid plan) — point the client at https://app.sophic.so/api/mcp with a Bearer API key. Nothing to install; runs on Sophic's infrastructure. Exposes the three read tools.
  • Local (free) — run the @sophic/mcp-server stdio server via npx. Works in every MCP client and adds the grep_knowledge_base and capture tools. See the MCP overview for the full tool list.

For the differences between transports, see Hosted vs. local.

Get a credential​

All clients authenticate with a workspace API key. Create one at Settings → Developer, then drop it into the config below in place of YOUR_API_KEY.

The local transport's capture tool needs a Personal Access Token (not an API key) plus SOPHIC_WORKSPACE, because writes are attributed to a user. See Authentication.

Claude Code​

Add the server with the CLI:

claude mcp add sophic npx -y @sophic/mcp-server@latest --env SOPHIC_API_KEY=YOUR_API_KEY

Or edit .mcp.json (project) / your global Claude config directly.

Hosted:

{
  "mcpServers": {
    "sophic": {
      "url": "https://app.sophic.so/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Local:

{
  "mcpServers": {
    "sophic": {
      "command": "npx",
      "args": ["-y", "@sophic/mcp-server@latest"],
      "env": {
        "SOPHIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor​

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project) — the JSON shape is identical to Claude Code above.

Hosted:

{
  "mcpServers": {
    "sophic": {
      "url": "https://app.sophic.so/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Local:

{
  "mcpServers": {
    "sophic": {
      "command": "npx",
      "args": ["-y", "@sophic/mcp-server@latest"],
      "env": {
        "SOPHIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Codex​

Codex uses TOML at ~/.codex/config.toml. The quickest path is the CLI, which writes the local config for you:

codex mcp add sophic \
  --env SOPHIC_API_KEY=YOUR_API_KEY \
  -- npx -y @sophic/mcp-server@latest

Hosted:

[mcp_servers.sophic]
url = "https://app.sophic.so/api/mcp"
headers = { Authorization = "Bearer YOUR_API_KEY" }

Local:

[mcp_servers.sophic]
command = "npx"
args = ["-y", "@sophic/mcp-server@latest"]
env = { SOPHIC_API_KEY = "YOUR_API_KEY" }

Antigravity​

Edit ~/.antigravity/mcp.json (global) or .antigravity/mcp.json (project) — same JSON shape as Claude Code and Cursor.

Hosted:

{
  "mcpServers": {
    "sophic": {
      "url": "https://app.sophic.so/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Local:

{
  "mcpServers": {
    "sophic": {
      "command": "npx",
      "args": ["-y", "@sophic/mcp-server@latest"],
      "env": {
        "SOPHIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Other clients​

Any MCP client works. For remote/hosted clients (Claude Desktop remote, ChatGPT connectors), point them at https://app.sophic.so/api/mcp with an Authorization: Bearer header. For stdio clients, run npx -y @sophic/mcp-server@latest. See the MCP overview.

Next steps​