Overzicht van de MCP-connector
Wat de officiële Novadesko-connector voor Claude, ChatGPT en Gemini doet, het adres, de compatibele clients en het verloop van een verbinding.
Novadesko publiceert een officiële MCP-server (Model Context Protocol). Daarmee kan een AI-assistent de gegevens van een Novadesko-bedrijf raadplegen en acties voorbereiden (offertes, facturen, klanten, herinneringen...), altijd met het uitdrukkelijke akkoord van de gebruiker. Dezelfde tools en regels gelden ook voor Nova AI, de assistent in Novadesko.
Adres van de server
Officieel adres om in uw AI-client te plakken: https://mcp.novadesko.com.
https://mcp.novadesko.com/mcpwordt ook aanvaard.- Het oude adres
https://web.novadesko.com/mcpblijft werken voor bestaande verbindingen. - Eenzelfde toegangstoken is geldig op de drie adressen.
HTTP-transport: JSON-RPC 2.0-berichten via POST. Aanvaarde protocolversies: 2025-06-18, 2025-03-26, 2024-11-05. Het domein mcp.novadesko.com bedient alleen MCP en OAuth: de rest van de applicatie is er niet bereikbaar.
Compatibele clients
| Client | Status | Opmerking |
|---|---|---|
| Claude (claude.ai, desktop-app, mobiele app) | beschikbaar | Aangepaste connector; hangt af van uw Claude-abonnement |
| Claude Code | beschikbaar | claude mcp add --transport http |
| ChatGPT | beschikbaar | Connectors van de ontwikkelaarsmodus |
| Gemini CLI | beschikbaar | gemini mcp add --transport http |
| Gemini Enterprise | preview bij Google | Client-ID door de beheerder aangemaakt in Novadesko |
| Gemini-app voor consumenten | niet beschikbaar in België | Door Google alleen aangekondigd in de VS, persoonlijke accounts met betaald abonnement |
Elke andere MCP-client die OAuth 2.1 met dynamische registratie ondersteunt, kan verbinden. Zijn verbindingen verschijnen in Novadesko op de pagina Integraties, Claude, zodat ze intrekbaar blijven.
Verloop van een verbinding
- De client roept
https://mcp.novadesko.comaan zonder token: antwoord 401 met de headerWWW-Authenticatedie naar de OAuth-metadata verwijst. - De client leest de metadata, registreert zich automatisch (dynamische registratie) en opent de Novadesko-autorisatiepagina.
- De gebruiker meldt zich zo nodig aan bij Novadesko, kiest één bedrijf en de toegekende rechten en klikt op Autoriseren.
- De client ruilt de code in voor een toegangstoken (PKCE S256) en roept
initializeen daarnatools/listaan. - Raadplegingen worden meteen uitgevoerd. Elke schrijf- of verzendactie gaat via een tool
prepare_*die een voorbeeld en een bevestigingstoken teruggeeft, en daarna viaconfirm_actionna akkoord van de gebruiker.
Wat de server niet aanbiedt
- geen verzending van documenten via Peppol (Peppol-verzending blijft manueel in Novadesko);
- geen toegang tot bestanden, het systeem, de database of de Novadesko-beheeromgeving;
- geen ander bedrijf dan het bij de autorisatie gekozen bedrijf;
- geen accountverwijdering of wachtwoordwijziging.
Het bedrijf komt altijd uit de OAuth-verbinding, nooit uit de argumenten. Parameters shop_id, company_id, user_id en gelijkaardige worden zonder fout verwijderd.