docs.semactic › MCP

Connect Semactic to an agent or another MCP client

Semactic has two MCP servers: one for the documentation, open to everyone without an account, and one for your Semactic data, reserved for customers (MCP add-on and API key).

This page gives their settings in a form an AI agent or a command-line MCP client can apply directly. For the Claude or ChatGPT interface, follow Connect Semactic to Claude or Connect Semactic to ChatGPT instead.

Documentation: public server, no account

The documentation MCP server is read-only and needs neither an account nor a key: https://docs.semactic.com/mcp/public.

claude mcp add --transport http semactic-docs-public https://docs.semactic.com/mcp/public

Semactic data: server settings

Setting Value
Server URL https://mcp.semactic.com/mcp
Transport HTTP (Streamable HTTP)
Authentication OAuth, authorization code with PKCE (S256)
Client registration Dynamic: leave the OAuth client ID and client secret empty
Credential requested Your Semactic API key, entered on the authorization page

[!NOTE] The MCP server requires the MCP add-on. Your API key is on the Semactic API card of the Integration page: see Semactic API and MCP server.

What the agent does, what you do

  • The agent adds the server to its MCP client configuration and starts the authorization.
  • You paste your API key on the authorization page that opens in your browser, then click Authorize.

[!WARNING] Do not paste your API key into a conversation or write it in a configuration file: enter it only on the Semactic authorization page. Anyone who has this key can read your data.

Claude Code

Add the server:

claude mcp add --transport http semactic https://mcp.semactic.com/mcp

In Claude Code, type /mcp, choose semactic and start the authentication. Your browser opens: paste your API key and click Authorize.

JSON configuration file

For a client that reads a configuration file (for example .mcp.json for Claude Code):

{
  "mcpServers": {
    "semactic": {
      "type": "http",
      "url": "https://mcp.semactic.com/mcp"
    }
  }
}

The exact field names depend on the client: some expect streamable-http as the type, others only the URL. Use the URL and transport from the table above in your client's format.

Check the connection

Ask the agent to call get_my_account_context, then list_projects: it should return your account and your projects. The full list of tools is described in Semactic MCP tools: overview.

If the connection fails

  • The server answers 401: the authorization was not completed or has expired. Start the authentication again from your client.
  • The key is refused: check that the MCP add-on is active and that the key is the right one. After Refresh key, the previous key stops working immediately.