One-Doc Coda MCP Server 🚀

Serveur Model Context Protocol (MCP) permettant aux agents AI (comme Cursor) d'interagir avec l'API Coda.io de manière ciblée sur un document unique.

✨ Fonctionnalités

• Architecture "Single-Doc" : Optimisé pour travailler sur un document spécifique (idéal pour les jetons API restreints).
• Transport Stdio : Compatible nativement avec Cursor IDE.
• Outils inclus :
  • coda_get_scope : Récupère le périmètre d'action (docId, permissions, table restreinte).
  • coda_list_pages : Liste toutes les pages du document.
  • coda_list_tables : Liste toutes les tables du document.
  • coda_create_page : Crée une page avec support du contenu Markdown.
  • coda_crud_rows : Opérations sur les lignes (list, create, update, delete).
  • coda_search_rows : Recherche textuelle partielle.
    • Note : Pour des raisons de performance et de pertinence, la recherche s'effectue sur les 20 dernières lignes de la table spécifiée.
  • coda_check_token : Diagnostic de l'environnement.

🚀 Utilisation avec Cursor

1. Configuration .env

Créez un fichier .env à la racine :

CODA_API_TOKEN=votre_jeton_coda
CODA_DOC_ID=votre_id_document_coda
CODA_PERMISSIONS=READ_ONLY # Options: READ_ONLY, READ_AND_CREATE, ALL_CRUD
CODA_TABLE_ID=votre_id_table_optionnel # Optionnel : Restreint les opérations à une table unique

🔐 Permissions et Restrictions

Permissions Globales (CODA_PERMISSIONS)

Le serveur supporte trois niveaux de permissions pour contrôler les actions des agents AI :

• READ_ONLY (Par défaut) : Autorise uniquement la lecture (list, get).
• READ_AND_CREATE : Autorise la lecture et la création de nouvelles pages ou lignes, mais interdit les modifications et suppressions.
• ALL_CRUD : Autorise toutes les opérations (lecture, création, modification, suppression).

Restriction par Table (CODA_TABLE_ID)

Si CODA_TABLE_ID est défini dans le fichier .env :

• Les opérations de lecture/écriture via coda_crud_rows ne sont autorisées que sur cette table spécifique.
• coda_list_tables ne retournera que cette table.
• Les opérations sur les pages (coda_list_pages, coda_create_page) sont désactivées pour garantir une isolation stricte.
• Si non défini, toutes les tables et pages du document sont accessibles selon les permissions globales.

2. Ajout dans Cursor

Ajoutez un nouveau serveur MCP dans les paramètres de Cursor :

Option A : Via Chemin Local

"coda-mcp": {
  "command": "node",
  "args": ["C:/chemin/vers/votre/projet/src/mcp-server.js"],
  "env": {
    "CODA_API_TOKEN": "...",
    "CODA_DOC_ID": "..."
  }
}

Option B : Via npx

"coda-mcp": {
  "command": "npx",
  "args": ["-y", "one-doc-coda-mcp-server"],
  "env": {
    "CODA_API_TOKEN": "...",
    "CODA_DOC_ID": "..."
  }
}

🛠️ Développement Local

npm install
npm start

📝 Documentation

Une analyse détaillée de l'architecture et des bonnes pratiques est disponible dans le dossier Ai_tasks/documentations/.