> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/dutch-documentation/automatisering-api-en-sdks/connect-ai-clients-mcp.md).

# Verbind AI-clients met MCP

Genereer een MCP-token in Instellingen → Automatisering en verbind Claude Desktop, Claude Code, Cursor, Windsurf, VS Code of Codex CLI met je Incogniton account.

Open **Instellingen** in het menu aan de linkerkant, klik op het tabblad **Automatisering** en klik op **Genereer MCP-token**. Kies vervolgens je AI-client onder **Installeer in je AI-client** en klik op **Kopieer configuratie**.

MCP (Model Context Protocol) laat een AI-client zoals Claude, Cursor of VS Code werken met je Incogniton-account. Je kunt het vragen om profielen te vinden, te maken of te bewerken, proxies, groepen en tags te beheren, en profielen te starten of te stoppen.

De verbinding verloopt via het npm-pakket `@incogniton/mcp`. Je AI-client start het met `npx`, dus je hebt [Node.js](https://nodejs.org/) 18 of nieuwer nodig op de computer waar de AI-client draait.

### Genereer je MCP-token

{% stepper %}
{% step %}

#### Open het tabblad Automatisering

Klik op **Instellingen** in het menu aan de linkerkant en klik vervolgens op het tabblad **Automatisering**. Scroll naar de sectie **MCP-token**.
{% endstep %}

{% step %}

#### Genereer het token

Klik op **Genereer MCP-token**. Het nieuwe token verschijnt in een veld onder de knop.
{% endstep %}

{% step %}

#### Kopieer en bewaar het

Klik op **Kopieer** naast het token en bewaar het ergens veilig, bijvoorbeeld in een wachtwoordmanager. Incogniton toont het token slechts één keer: **Waarschuwing: Je kunt dit token later niet meer ophalen — kopieer en bewaar het nu.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Behandel het MCP-token als een wachtwoord. Iedereen die het heeft, kan de profielen van je account beheren. Deel het nooit of plak het niet in een openbaar bestand.
{% endhint %}

### Vervang of herroep je token

Je hebt één actief MCP-token tegelijk. Nogmaals klikken op **Genereer MCP-token** creëert een nieuw token en maakt het oude ongeldig. Werk het token bij in elke AI-client die je hebt verbonden.

Om alle toegang te stoppen, klik op **Herroep** onder **Actieve tokens**. Wanneer er geen token actief is, toont de sectie **Geen actieve tokens**.

### Voeg Incogniton toe aan je AI-client

Onder **Installeer in je AI-client**, open de **AI-client** dropdown en kies je client: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code of Codex CLI. Incogniton toont een kant-en-klare configuratie met je nieuwe token al ingevuld, en vertelt je waar je het moet plakken. Klik op **Kopieer configuratie**, plak het waar de app je vertelt, en herstart de AI-client.

Genereer eerst het token. Als je deze lijst later opent, bevat de configuratie `YOUR_MCP_TOKEN` in plaats van een token: vervang het door het token dat je hebt opgeslagen.

Voor handmatige installatie in andere MCP-clients, zie de [MCP-serverdocumentatie](https://api-docs.incogniton.com/mcp).

### Wat de AI-client kan doen via MCP

Nadat je verbinding hebt gemaakt, kan je AI-client:

* **Profielen:** zoeken, maken, bewerken en klonen van profielen, en opzoeken van de groepen, tags, proxies en browsertalen die je kunt gebruiken voor een nieuw profiel.
* **Groepen en tags:** zoeken en maken van profielgroepen en tags.
* **Proxies:** zoeken en toevoegen van proxies, en zoeken en maken van proxygroepen.
* **Team:** teamleden opzoeken.
* **Starten en stoppen:** zien welke computers een profiel kunnen starten, een profiel starten, controleren of een start of stop is gelukt, en een profiel stoppen.
* **Cloudtelefoons:** je cloudtelefoons weergeven, een cloudtelefoon maken met een proxy uit je Proxybibliotheek, en cloudtelefoons starten of stoppen. Telefoons die via MCP worden gestart, starten zonder scherm.

De volledige lijst met tools staat in de [MCP-serverdocumentatie](https://api-docs.incogniton.com/mcp).

### Hoe starten werkt via MCP

Een profiel opent altijd in de Incogniton-app op een van je computers. Die computer moet de app open hebben en ingelogd zijn op je account.

* Als er één computer beschikbaar is, wordt het profiel daar gestart. Als er meerdere zijn, krijgt de AI-client de lijst met computers en kies je er een.
* Een startverzoek dat binnen 5 minuten door geen enkele computer wordt opgepakt, verloopt.
* MCP kan alleen profielen stoppen die via MCP zijn gestart. Sluit een profiel dat je zelf hebt geopend vanuit de Incogniton-app.

### Beheer de browser na een MCP-start

MCP zelf opent en sluit alleen profielen. Het kan niet klikken, typen of pagina's lezen binnen de browser.

Na een start kan de AI-client een lokaal DevTools-adres (`cdp_url`) van de draaiende browser krijgen. Een AI-client die code kan uitvoeren, kan Puppeteer, Playwright of een browser-MCP met dat adres verbinden.

{% hint style="info" %}
De `cdp_url` werkt alleen wanneer de AI-client draait op **dezelfde computer** als de Incogniton-app die het profiel heeft gestart. Het werkt niet vanaf een andere computer, of vanaf een client die geen code kan uitvoeren, zoals Claude Desktop. Het moet ook **Browser op afstand bedienen toestaan** aan hebben staan in het tabblad Automatisering. Zie [Browser op afstand bedienen](https://docs.incogniton.com/documentation/dutch-documentation/automatisering-api-en-sdks/browser-remote-control.md).
{% endhint %}

### Wat MCP niet kan doen

Deze acties zijn niet beschikbaar via MCP:

* Een URL openen, tabbladen beheren of pagina's lezen in een draaiend profiel.
* Controleren of een proxy werkt.
* Profielen verwijderen.
* Een profiel herstellen vanuit een back-up.

Cas, de AI-assistent binnen de Incogniton-app, kan deze doen. Open Cas in de app om ze te gebruiken.

### Problemen oplossen

* **De client toont geen Incogniton-tools:** herstart de AI-client nadat je de configuratie hebt geplakt, en controleer of Node.js 18 of nieuwer is geïnstalleerd.
* **De MCP-log van de client toont "missing bearer token":** het token ontbreekt in de configuratie. Plak je token in plaats van `YOUR_MCP_TOKEN`.
* **Authenticatiefouten:** het token is vervangen of herroepen. Genereer een nieuwe en werk de configuratie bij.

Voor scripts die op je eigen computer draaien, kun je ook de [lokale REST API](https://docs.incogniton.com/documentation/dutch-documentation/automatisering-api-en-sdks/local-rest-api.md) of de [JavaScript en Python SDK](https://docs.incogniton.com/documentation/dutch-documentation/automatisering-api-en-sdks/javascript-and-python-sdk.md) gebruiken.
