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.