MCP (Model Context Protocol) permet à des assistants IA comme Claude, Cursor, VS Code Copilot, Codex, Gemini ou Windsurf de travailler avec vos données Okinta : lire contacts, commandes et factures, consulter vos rapports, et créer ou modifier des données quand vous l'autorisez. Toute application compatible avec les serveurs MCP distants peut se connecter.
Allez dans Paramètres → API et créez une clé avec uniquement les permissions dont l'assistant a besoin (en lecture seule pour commencer). Pour essayer sans risque, créez une clé de test (okt_test_…) : elle n'atteint que votre bac à sable.
https://api.okinta.io/mcpCollez le texte ci-dessous dans Cursor, Claude, ChatGPT (avec MCP) ou tout assistant capable de modifier les réglages MCP. Quand il demande votre clé, collez-la depuis Paramètres → API (utilisez un libellé dans les fichiers de config, pas le secret réel dans git).
Connecte Okinta comme serveur MCP distant dans cette application.
- URL : https://api.okinta.io/mcp
- Transport : HTTP (distant / Streamable HTTP)
- En-tête d'auth : Authorization: Bearer YOUR_KEY
Choisis le bon fichier de configuration pour cette app (par exemple ~/.cursor/mcp.json dans Cursor) et ajoute le serveur avec cet en-tête. Je te donnerai la clé API au message suivant quand tu la demanderas.
Quand c'est fait, liste les outils MCP Okinta pour confirmer que ça fonctionne.claude mcp add --transport http okinta https://api.okinta.io/mcp \
--header "Authorization: Bearer YOUR_KEY"Ajoutez ceci à claude_desktop_config.json (Paramètres → Développeur → Modifier la config) :
{
"mcpServers": {
"okinta": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.okinta.io/mcp", "--header", "Authorization:${OKINTA_AUTH}"],
"env": { "OKINTA_AUTH": "Bearer YOUR_KEY" }
}
}
}La plupart des applications acceptent l'adresse du serveur et un en-tête Authorization dans leurs réglages MCP (souvent mcp.json). Cursor (~/.cursor/mcp.json) :
{
"mcpServers": {
"okinta": { "url": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Ajoutez ceci à .vscode/mcp.json ou lancez MCP: Open User Configuration :
{
"servers": {
"okinta": { "type": "http", "url": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Ajoutez ceci à ~/.codeium/windsurf/mcp_config.json (Windsurf appelle l'adresse serverUrl) :
{
"mcpServers": {
"okinta": { "serverUrl": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Gardez la clé dans une variable d'environnement, puis ajoutez ceci à ~/.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"Ajoutez ceci à ~/.gemini/settings.json :
{
"mcpServers": {
"okinta": { "httpUrl": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Si une application ne gère que les serveurs locaux (stdio), utilisez le pont mcp-remote :
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…Connexion en un clic, sans copier de clé (se connecter avec Okinta), pour les applications qui exigent OAuth.
Le serveur MCP utilise les mêmes clés, permissions et limites que l'API : un assistant n'accède jamais à plus que ce que le créateur de la clé peut ouvrir dans l'application. Révoquez la clé dans Paramètres → API pour le déconnecter immédiatement.