Этот проект реализует сервер Model Context Protocol (MCP), который действует как мост для взаимодействия с API Coda. Он позволяет клиенту MCP (например, помощнику ИИ) выполнять действия на страницах Coda, такие как листинг, создание, чтение, обновление, дублирование и переименование.

[!ПРИМЕЧАНИЕ] Этот MCP-сервер не разрабатывается и не поддерживается Coda; это проект, созданный сообществом.

Особенности

Сервер предоставляет клиенту MCP следующие инструменты:

• coda_list_documents: Перечислите все документы, доступные пользователю. coda_list_pages: Перечисляет все страницы в сконфигурированном документе Coda с поддержкой пагинации.
• coda_create_page: Создает новую страницу в документе, необязательно под указанной родительской страницей (создает подстраницу) и заполняет ее первоначальным контентом разметки. [[Т3]]: Получает содержимое определенной страницы (по идентификатору или имени) в виде разметки.
• coda_replace_page_content: Заменяет содержимое определенной страницы новым контентом разметки. [[Т5]]: Добавляет новый контент разметки в конец определенной страницы.
• coda_duplicate_page: Создает копию существующей страницы с новым именем.

Coda MCP Server

This project implements a Model Context Protocol (MCP) server that acts as a bridge to interact with the Coda API. It allows an MCP client (like an AI assistant) to perform actions on Coda pages, such as listing, creating, reading, updating, duplicating, and renaming.

[!NOTE]
This MCP server is not developed or maintained by Coda; it’s a community-built project.

Features

The server exposes the following tools to the MCP client:

• coda_list_documents: Lists all documents available to the user.
• coda_list_pages: Lists all pages within the configured Coda document with pagination support.
• coda_create_page: Creates a new page in the document, optionally under a specified parent page (creating a subpage) and populating it with initial markdown content.
• coda_get_page_content: Retrieves the content of a specified page (by ID or name) as markdown.
• coda_replace_page_content: Replaces the content of a specified page with new markdown content.
• coda_append_page_content: Appends new markdown content to the end of a specified page.
• coda_duplicate_page: Creates a copy of an existing page with a new name.
• coda_rename_page: Renames an existing page.
• coda_peek_page: Peek into the beginning of a page and return a limited number of lines.
• coda_resolve_link: Resolve metadata given a browser link to a Coda object.
• coda_list_tables: List tables in a document.
• coda_list_columns: List columns in a table.
• coda_list_rows: List rows in a table with optional filtering and sorting.
• coda_get_row: Get a single row from a table.
• coda_upsert_rows: Insert or upsert rows into a table.
• coda_update_row: Update a single row in a table.
• coda_delete_row: Delete a single row from a table.
• coda_delete_rows: Delete multiple rows from a table.
• coda_push_button: Push a button column on a row in a table.

Usage

Add the MCP server to Cursor/Claude Desktop/etc. like so:

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

Required environment variables:

• API_KEY: Your Coda API key. You can generate one from your Coda account settings.

This MCP server is also available with Docker, like so:

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

Local Setup

1. Prerequisites:

   • Node.js
   • pnpm

2. Clone the repository:

   git clone 
   cd coda-mcp
   

3. Install dependencies:

   pnpm install
   

4. Build the project:

   pnpm build