Coda Io MCP

Coda MCP服务器

模型上下文协议（MCP）服务器提供对 Coda API v1这使得像Claude这样的AI编码代理能够与Coda文档、表、行、公式等进行交互。

特性

• 51工具 覆盖整个Coda API表面
• 对文档、页面、表格和行执行完整的CRUD操作
• 公式和控制访问
• 权限和共享管理
• 发布和文件夹操作
• 自定义域管理
• 异步操作跟踪

快速开始

使用此MCP服务器的最简单方法是通过npx（无需安装）：

1. 获取您的Coda API密钥 从 https://coda.io/account （帐户设置>API）

1. 添加到您的Claude Desktop配置中：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "coda": {
      "command": "npx",
      "args": ["-y", "coda-io-mcp@latest"],
      "env": {
        "CODA_API_KEY": "your-coda-api-key"
      }
    }
  }
}

1. 重新启动克劳德桌面 并开始与您的Coda文档互动！

安装

选项1:npx（推荐）

无需安装！只需使用上面的快速启动配置。这 npx 命令会自动从npm下载并运行最新版本。

优点：

• 无需手动安装或路径配置
• 始终使用最新版本 @latest
• 在macOS、Windows和Linux上的工作原理相同
• Claude Desktop重启时自动更新

选项2：从GitHub安装（用于开发）

如果你想修改代码或贡献：

# Clone the repository
git clone https://github.com/bluestemso/coda-io-mcp.git
cd coda-io-mcp

# Install dependencies and build
npm install

这 prepare 脚本将在安装后自动构建项目。

Claude桌面配置：

{
  "mcpServers": {
    "coda": {
      "command": "node",
      "args": ["/absolute/path/to/coda-io-mcp/build/index.js"],
      "env": {
        "CODA_API_KEY": "your-api-key-here"
      }
    }
  }
}

替换 /absolute/path/to/coda-io-mcp 使用克隆存储库的实际路径。

选项3：全局npm安装

npm install -g coda-io-mcp@latest

Claude桌面配置：

{
  "mcpServers": {
    "coda": {
      "command": "coda-io-mcp",
      "env": {
        "CODA_API_KEY": "your-api-key-here"
      }
    }
  }
}

重要：替换 your-api-key-here 在所有配置中使用您的实际Coda API密钥。

添加配置后，重新启动Claude Desktop以加载服务器。

先决条件

• Node.js 18或更高版本（所有安装方法都需要）
• 来自的Coda API密钥 https://coda.io/account （帐户设置>API）

用法

使用克劳德桌面

配置后，您可以使用Claude的自然语言与您的Coda文档进行交互。例如：

• “列出我的所有Coda文档”
• “创建一个名为“项目跟踪器”的新文档”
• 在“任务”表中添加一行，状态为“进行中”
• “获取‘总收入’公式的值”
• “与共享文档user@example.com作为编辑”
• “将需求页面导出为markdown”

独立测试

直接运行服务器（需要 CODA_API_KEY 环境变量）：

export CODA_API_KEY=your-api-key-here
node build/index.js

与MCP检查员一起

使用MCP检查器测试服务器：

export CODA_API_KEY=your-api-key-here
npx @modelcontextprotocol/inspector node build/index.js

可用工具

账户（1个工具）

• coda_whoami -获取经过身份验证的用户信息

文档（5个工具）

• coda_list_docs -列出可访问的文档
• coda_create_doc -创建新文档
• coda_get_doc -获取文档元数据
• coda_update_doc -更新文档标题
• coda_delete_doc -删除文档

页面（9个工具）

• coda_list_pages -列出文档中的页面
• coda_create_page -创建新页面
• coda_get_page -获取页面信息
• coda_update_page -更新页面
• coda_delete_page -删除页面
• coda_list_page_content -列表页面内容
• coda_delete_page_content -删除页面内容
• coda_export_page -起始页导出
• coda_get_export_status -检查导出状态

表（2个工具）

• coda_list_tables -列出表和视图
• coda_get_table -获取表格信息

列（2个工具）

• coda_list_columns -列出表中的列
• coda_get_column -获取列信息

行（7个工具）

• coda_list_rows -列出具有筛选功能的行
• coda_upsert_rows -插入或更新行
• coda_delete_rows -批量删除行
• coda_get_row -获取单行
• coda_update_row -更新行
• coda_delete_row -删除行
• coda_push_button -按下按钮

公式（2个工具）

• coda_list_formulas -列出公式
• coda_get_formula -获取公式值

控件（2个工具）

• coda_list_controls -列表控件
• coda_get_control -获取控制值

权限（7个工具）

• coda_get_sharing_metadata -获取共享信息
• coda_list_permissions -列出权限
• coda_add_permission -添加权限
• coda_delete_permission -删除权限
• coda_search_principals -搜索用户/组
• coda_get_acl_settings -获取ACL设置
• coda_update_acl_settings -更新ACL设置

出版（3个工具）

• coda_list_categories -列出文档类别
• coda_publish_doc -发布到图库
• coda_unpublish_doc -从图库中取消发布

文件夹（5个工具）

• coda_list_folders -列出文件夹
• coda_create_folder -创建文件夹
• coda_get_folder -获取文件夹信息
• coda_update_folder -更新文件夹
• coda_delete_folder -删除文件夹

自定义域（5个工具）

• coda_list_domains -列出自定义域
• coda_add_domain -添加自定义域
• coda_update_domain -更新域
• coda_delete_domain -删除域
• coda_get_domain_provider -获取DNS提供商

突变（1个工具）

• coda_get_mutation_status -检查异步操作状态

示例用法

一旦配置了Claude Desktop，您可以要求Claude：

• “列出我的所有Coda文档”
• “创建一个名为“项目跟踪器”的新文档”
• 在“任务”表中添加一行，状态为“进行中”
• “获取‘总收入’公式的值”
• “与共享文档user@example.com作为编辑”
• “将需求页面导出为markdown”

故障排除

服务器未显示在Claude Desktop中

1. 确保在添加配置后重新启动了Claude Desktop
2. 检查以下路径 build/index.js 是正确和绝对的（不是相对的）
3. 验证您的配置文件是有效的JSON（如果需要，请使用JSON验证器）
4. 检查Claude Desktop的日志以获取错误消息

“需要CODA_API_KEY”错误

1. 确保您已添加 env 部分与 CODA_API_KEY 在您的配置中
2. 验证API密钥是否正确（没有额外的空格或引号）
3. 确保您已从Coda正确复制密钥

工具不工作/API错误

1. 验证您的Coda API密钥是否具有必要的权限
2. 检查您是否有权访问您尝试访问的文档/表
3. 某些操作需要Coda中的特定权限级别

查找安装路径

如果您克隆了存储库并需要找到绝对路径：

cd coda-io-mcp
pwd

这将输出完整路径（例如。， /Users/yourname/projects/coda-io-mcp).使用此路径+ /build/index.js 在您的配置中。

发展

对于想要修改或扩展服务器的贡献者：

# Clone the repository
git clone https://github.com/bluestemso/coda-io-mcp.git
cd coda-io-mcp

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development (auto-rebuild on changes)
npm run watch

项目结构

• src/index.ts -MCP服务器入口点
• src/coda-client.ts -Coda API的HTTP客户端
• src/tools/ -单个工具实施（13个模块，共51个工具）

贡献

欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

支持

• 问题:
• Coda API文档: https://coda.io/developers/apis/v1
• MCP文件: https://modelcontextprotocol.io

许可证

麻省理工学院