# 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](https://docs.semactic.com/mcp/connect-claude) of [Semactic met ChatGPT verbinden](https://docs.semactic.com/mcp/connect-chatgpt).

## 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`.

```bash
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](https://docs.semactic.com/integrations/semactic-api).

## 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:

```bash
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):

```json
{
  "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](https://docs.semactic.com/mcp-tools/overview).

## 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.
