AI-apps koppelen (MCP)

Met de MonoChat MCP Server kan een AI-app die het Model Context Protocol (MCP) ondersteunt, zoals Claude Code of Cursor, met uw MonoChat-account werken. De AI-app vraagt MonoChat via een vaste set tools om gegevens en kan alleen zien wat u zelf kunt zien.

De MonoChat MCP Server is beschikbaar bij elk abonnement, zonder limieten per abonnement.

Een verbinding handelt als uzelf

Een AI-app die met uw toegangssleutel is verbonden, handelt als uw gebruiker. De app bereikt de tenants waartoe u toegang hebt en niets anders. Trek verbindingen in die u niet meer gebruikt.

Wat de AI-app kan doen

Deze tools zijn beschikbaar voor elke verbinding:

Tool	Wat het doet
list_tenants	Toont de tenants waartoe de verbinding toegang heeft.
list_sessions	Toont de gespreksessies van een tenant, nieuwste eerst, desgewenst alleen opened, assigned of closed.
get_session	Geeft één gespreksessie terug.
list_messages	Toont de berichten van een sessie, nieuwste eerst.
search_customers	Zoekt de klanten van een tenant op trefwoord.
list_message_templates	Toont de berichtsjablonen van één kanaal van een tenant.

Berichttekst komt van klanten en medewerkers. Het zijn gegevens die de AI-app leest, geen instructies.

Een verbinding heeft een bereik: Alleen lezen of Lezen en schrijven. Een verbinding met alleen leesrechten ziet nooit tools die gegevens wijzigen. Alle hierboven genoemde tools lezen alleen.

Een verbinding aanmaken

Een verbinding hoort bij uw account, niet bij een tenant. U moet eerst tweestapsverificatie (per e-mail of met een authenticator-app) hebben ingesteld.

1. Open uw profielinstellingen, selecteer het tabblad MCP-verbindingen en klik op Aanmaken.
2. Voer een naam in, kies het bereik (standaard Alleen lezen) en de geldigheid in dagen (standaard 90, maximaal 365).
3. Voer de 6-cijferige bevestigingscode van uw tweestapsverificatie in. Gebruikt u verificatie per e-mail, klik dan eerst op Bevestigingscode versturen.
4. Kopieer de toegangssleutel. Deze wordt maar één keer getoond en begint met mcp_sk_.

U kunt maximaal 10 actieve verbindingen hebben.

Een AI-app koppelen

De server staat op https://app.monochat.ai/api/mcp-server (gebruik uw eigen MonoChat-adres als u MonoChat op uw eigen servers draait) en verwacht de toegangssleutel als bearer-token in de header Authorization.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

Voeg de server toe aan ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Elke andere MCP-client die streamable HTTP-transport en eigen headers ondersteunt, koppelt op dezelfde manier.

Limieten

Aanroepen worden per minuut geteld: 60 per verbinding, 300 per account en 600 per tenant, en maximaal 4 gelijktijdige aanroepen per verbinding. Sommige tools tellen als meer dan één aanroep. Wanneer een limiet is bereikt, antwoordt de server met de status 429 en een Retry-After-header; de AI-app moet dat aantal seconden wachten.

Een verbinding intrekken

Elke verbinding op het tabblad MCP-verbindingen toont de status, het bereik, de verloopdatum en het laatste gebruik. Klik op Intrekken om de AI-app direct de toegang te ontzeggen. Een verbinding die is ingetrokken of verlopen, kan niet opnieuw worden gebruikt; maak in plaats daarvan een nieuwe aan.

MCP-toegang voor een organisatie beheren

Gebruikers die de instellingen van een organisatie mogen wijzigen, beheren de MCP-toegang in Instellingen › Organisatie › MCP-server.

• MCP-toegang voor deze organisatie uitschakelen: zet dit aan en klik op Opslaan om elke MCP-aanroep naar deze organisatie te weigeren, vanaf elke verbinding van elke gebruiker. De organisatie verschijnt dan niet meer in list_tenants. Zet het uit en sla op om MCP-toegang weer toe te staan.
• MCP-aanroepen: elke aanroep van een tool die deze organisatie noemt, nieuwste eerst, geweigerde aanroepen inbegrepen. Elke rij toont de gebruiker, de verbinding, de tool, de status (Gelukt of Mislukt), het IP-adres en het tijdstip. Aanroepen van gebruikers die geen lid zijn van deze organisatie worden niet getoond.