Coda

Servidor MCP de Coda

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que actúa como puente para interactuar con la API de Coda. Permite que un cliente MCP (como un asistente de IA) realice acciones en páginas de Coda, como listar, crear, leer, actualizar, duplicar y renombrar.

[!NOTE]
Este servidor MCP no está desarrollado ni mantenido por Coda; es un proyecto construido por la comunidad.

Características

El servidor expone las siguientes herramientas al cliente MCP:

• coda_list_documents: Lista todos los documentos disponibles para el usuario.
• coda_list_pages: Lista todas las páginas dentro del documento de Coda configurado con soporte de paginación.
• coda_create_page: Crea una nueva página en el documento, opcionalmente bajo una página principal especificada (creando una subpágina) y la rellena con contenido inicial en markdown.
• coda_get_page_content: Recupera el contenido de una página especificada (por ID o nombre) como markdown.
• coda_replace_page_content: Reemplaza el contenido de una página especificada con nuevo contenido markdown.
• coda_append_page_content: Añade nuevo contenido markdown al final de una página especificada.
• coda_duplicate_page: Crea una copia de una página existente con un nuevo nombre.
• coda_rename_page: Renombra una página existente.
• coda_peek_page: Echa un vistazo al principio de una página y devuelve un número limitado de líneas.
• coda_resolve_link: Resuelve metadatos dado un enlace de navegador a un objeto de Coda.
• coda_list_tables: Lista tablas en un documento.
• coda_list_columns: Lista columnas en una tabla.
• coda_list_rows: Lista filas en una tabla con filtrado y ordenación opcionales.
• coda_get_row: Obtiene una sola fila de una tabla.
• coda_upsert_rows: Inserta o actualiza filas en una tabla (upsert).
• coda_update_row: Actualiza una sola fila en una tabla.
• coda_delete_row: Elimina una sola fila de una tabla.
• coda_delete_rows: Elimina múltiples filas de una tabla.
• coda_push_button: Pulsa una columna de botón en una fila de una tabla.

Uso

Añade el servidor MCP a Cursor/Claude Desktop/etc. de la siguiente manera:

{
  "mcpServers": {
    "coda": {
      "command": "npx",
      "args": ["-y", "coda-mcp@latest"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

Variables de entorno requeridas:

• API_KEY: Tu clave de API de Coda. Puedes generar una desde la configuración de tu cuenta de Coda.

Este servidor MCP también está disponible con Docker, de la siguiente manera:

{
  "mcpServers": {
    "coda": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "API_KEY", "reaperberri/coda-mcp:latest"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

Configuración Local

1. Requisitos previos:

   • Node.js
   • pnpm

2. Clona el repositorio:

   git clone <repository-url>
   cd coda-mcp
   

3. Instala las dependencias:

   pnpm install
   

4. Compila el proyecto:

   pnpm build
   

   Esto compila el código TypeScript a JavaScript en el directorio dist/.

Ejecutar el Servidor

El servidor MCP se comunica a través de entrada/salida estándar (stdio). Para ejecutarlo, establece las variables de entorno y ejecuta el archivo JavaScript compilado - dist/index.js.