Met MCP (Model Context Protocol) kunnen AI-assistenten zoals Claude, Cursor, VS Code Copilot, Codex, Gemini of Windsurf met je Okinta-gegevens werken: contacten, bestellingen en facturen lezen, je rapporten bekijken en gegevens aanmaken of bijwerken als jij dat toestaat. Elke app die externe MCP-servers ondersteunt, kan verbinden.
Ga naar Instellingen → API en maak een sleutel met alleen de rechten die de assistent nodig heeft (eerst alleen-lezen). Om veilig te proberen maak je een testsleutel (okt_test_…): die bereikt alleen je sandbox.
https://api.okinta.io/mcpPlak de tekst hieronder in Cursor, Claude, ChatGPT (met MCP) of een andere assistent die MCP-instellingen kan aanpassen. Als er om je sleutel wordt gevraagd, plak die uit Instellingen → API (gebruik een placeholder in configbestanden, niet het echte geheim in git).
Verbind Okinta als externe MCP-server in deze app.
- URL: https://api.okinta.io/mcp
- Transport: HTTP (extern / Streamable HTTP)
- Auth-header: Authorization: Bearer YOUR_KEY
Kies het juiste configbestand voor deze app (bijvoorbeeld ~/.cursor/mcp.json in Cursor) en voeg de server toe met die header. Ik geef je de API-sleutel in het volgende bericht als je erom vraagt.
Als je klaar bent, toon de Okinta MCP-tools om te controleren of het werkt.claude mcp add --transport http okinta https://api.okinta.io/mcp \
--header "Authorization: Bearer YOUR_KEY"Voeg dit toe aan claude_desktop_config.json (Instellingen → Ontwikkelaar → Config bewerken):
{
"mcpServers": {
"okinta": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.okinta.io/mcp", "--header", "Authorization:${OKINTA_AUTH}"],
"env": { "OKINTA_AUTH": "Bearer YOUR_KEY" }
}
}
}De meeste apps nemen het serveradres en een Authorization-header op in hun MCP-instellingen (vaak mcp.json). Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"okinta": { "url": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Voeg dit toe aan .vscode/mcp.json of voer MCP: Open User Configuration uit:
{
"servers": {
"okinta": { "type": "http", "url": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Voeg dit toe aan ~/.codeium/windsurf/mcp_config.json (Windsurf noemt het adres serverUrl):
{
"mcpServers": {
"okinta": { "serverUrl": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Bewaar de sleutel in een omgevingsvariabele en voeg dit toe aan ~/.codex/config.toml:
export OKINTA_API_KEY=YOUR_KEY
[mcp_servers.okinta]
url = "https://api.okinta.io/mcp"
bearer_token_env_var = "OKINTA_API_KEY"Voeg dit toe aan ~/.gemini/settings.json:
{
"mcpServers": {
"okinta": { "httpUrl": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Ondersteunt een app alleen lokale (stdio-)servers, gebruik dan de mcp-remote-brug:
npx -y mcp-remote https://api.okinta.io/mcp \
--header "Authorization: Bearer YOUR_KEY"list_contacts, get_invoice, create_expense, issue_quote, get_profit_and_loss_report…Verbinden met één klik, zonder een sleutel te kopiëren (inloggen met Okinta), voor apps die OAuth nodig hebben.
De MCP-server gebruikt dezelfde sleutels, rechten en limieten als de API: een assistent kan nooit meer bereiken dan de maker van de sleutel in de app kan openen. Trek de sleutel in via Instellingen → API om hem meteen los te koppelen.