docs.semactic › MCP

Semactic verbinden met een agent of een andere MCP-client

Semactic heeft twee MCP-servers: die van de documentatie, open voor iedereen zonder account, en die van uw Semactic-gegevens, voorbehouden aan klanten (add-on MCP en API-sleutel).

Deze pagina geeft hun instellingen in een vorm die een AI-agent of een MCP-client op de opdrachtregel rechtstreeks kan toepassen. Voor de interface van Claude of ChatGPT volgt u beter Semactic verbinden met Claude of Semactic met ChatGPT verbinden.

Documentatie: openbare server, zonder account

De MCP-server van de documentatie is alleen-lezen en vraagt geen account of sleutel: https://docs.semactic.com/mcp/public.

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

Semactic-gegevens: serverinstellingen

Instelling Waarde
Server-URL https://mcp.semactic.com/mcp
Transport HTTP (Streamable HTTP)
Authenticatie OAuth, autorisatiecode met PKCE (S256)
Clientregistratie Dynamisch: laat de OAuth-client-ID en het clientgeheim leeg
Gevraagde sleutel Uw Semactic API-sleutel, ingevoerd op de autorisatiepagina

[!NOTE] De MCP-server vereist de add-on MCP. Uw API-sleutel staat op de kaart Semactic API van de pagina Integration: zie Semactic-API en MCP-server.

Wat de agent doet, wat u doet

  • De agent voegt de server toe aan de configuratie van zijn MCP-client en start de autorisatie.
  • U plakt uw API-sleutel op de autorisatiepagina die in uw browser opent en klikt op Authorize.

[!WARNING] Plak uw API-sleutel niet in een gesprek en schrijf hem niet in een configuratiebestand: voer hem alleen in op de autorisatiepagina van Semactic. Iedereen die deze sleutel heeft, kan uw gegevens lezen.

Claude Code

Voeg de server toe:

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

Typ daarna in Claude Code /mcp, kies semactic en start de authenticatie. Uw browser opent: plak uw API-sleutel en klik op Authorize.

JSON-configuratiebestand

Voor een client die een configuratiebestand leest (bijvoorbeeld .mcp.json voor Claude Code):

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

De exacte veldnamen hangen af van de client: sommige verwachten streamable-http als type, andere alleen de URL. Neem de URL en het transport uit de tabel hierboven over in het formaat van uw client.

De verbinding controleren

Vraag de agent om get_my_account_context aan te roepen en daarna list_projects: hij moet uw account en uw projecten terugkrijgen. De volledige lijst met tools staat in Semactic MCP-tools: overzicht.

Als de verbinding mislukt

  • De server antwoordt 401: de autorisatie is niet uitgevoerd of is verlopen. Start de authenticatie opnieuw vanuit uw client.
  • De sleutel wordt geweigerd: controleer of de add-on MCP actief is en of de sleutel de juiste is. Na Refresh key werkt de oude sleutel onmiddellijk niet meer.