Attio MCP Server

社区

AI驱动的Attio CRM访问：通过自然语言管理联系人、公司、交易、任务、笔记和工作流。

分类: 团队协作第 33 / 55
Stars: ★ 69 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: 其他 / 未声明
最近提交: 今天
工具数: 24

52FMRS · D

Attio MCP Server是一个功能丰富的MCP服务器，为Attio CRM提供全面的工具集，包括通用工具、列表管理和预构建提示。它适合希望将AI助手集成到CRM工作流中的用户。虽然项目非官方，但广泛文档化且活跃维护。需要API密钥，并注意数据修改权限。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

11/20

维护活跃度

10/20

文档质量

12/20

安装易用性

12/20

查看各项评分依据

可靠性 7/20: 证据仅来自 README 与 server.json（均属不可信证据），未提供任何源码、CI 工作流或已提交测试可供验证。README 存在多处内部矛盾：工具数量口径不一（19 个通用工具 vs 全量 41 个 vs “40+ 资源专属工具合并”）；Node 版本要求不一致（徽章为 ≥20，前置要求写 v18+）；manifest 的环境变量列表缺少 README 中记载的 ATTIO_ACCESS_TOKEN、ATTIO_DEFAULT_DEAL_STAGE 等；manifest 版本为 1.6.1，而 README 主打 v1.4.0；README 还自认“通用工具文档正在更新以匹配最新实现”。即使正常路径看似可行，也无法从现有材料复现或验证，故扣除至 7 分。
安全与权限 11/20: 未触发红线：安装示例中的密钥均为占位符（your_api_key_here），未发现真实令牌、恶意代码或外泄模式。ATTIO_API_KEY 在 manifest 中正确标记为必填且 secret，属良好实践；README 声称借助 MCP 安全注解（readOnlyHint/destructiveHint）区分只读与写操作、提供 search-only 弱权限模式及 dry-run 提示，但均无法从源码证实。扣分原因：API key 具备全工作区 CRUD（含删除与批量删除）权限，未见强制确认机制的证据；远端 Cloudflare Worker 部署扩大攻击面；90 个未关闭 issue 中可能包含未解决的安全问题。综合评 11 分。
维护活跃度 10/20: 仓库未归档，manifest 版本为 1.6.1，README 引用大量 PR 编号并声称通过 npm provenance（Sigstore）发布，显示持续开发与版本工程。但扣分点：仓库元数据显示 License 为 NOASSERTION，与 README 声称的 Apache 2.0 不一致，构成治理缺口；90 个未关闭 issue 相对 69 stars 偏高；README 仍以 v1.4.0 版本内容为主，落后于 manifest 的 1.6.1，版本说明更新滞后；未披露安全漏洞响应渠道。因此评 10 分。
文档质量 12/20: README 层次较丰富：分档安装说明、各客户端配置 JSON 示例、工具与提示词表格、迁移指南、故障排查链接、docs 目录及使用示例齐全，并披露了部分已知限制（tasks 属性过滤、分页）与成本信息（Cloudflare 免费层）。扣分原因：存在多处矛盾（Node 版本、工具数量、环境变量清单）；自认“通用工具文档尚未跟上最新实现”；字段映射配置被标为“CRITICAL”且隐含较多假设；未说明 Attio API 本身的成本。评 12 分。
安装易用性 12/20: 提供了 npm 全局安装、shell 一键脚本、Claude Desktop/Cursor/Claude Code 手动配置 JSON 示例、Docker 与 Cloudflare Worker 等多种安装路径，主流客户端覆盖良好。扣分原因：整体步骤偏多且较脆弱——必须手动复制并编辑字段映射 user.json，否则“可能无法正常工作”；存在包名陷阱（安装 attio-mcp-server 会得到过时的 v0.0.2）；shell 安装脚本为 curl 管道执行 bash；且未提供可验证的执行级证据（真实 CI 加已提交测试），按静态校准规则 setup 上限为 15。评 12 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

希望使用AI助手自动化CRM工作流、减少手动输入的Attio用户
需要与Claude Desktop、Cursor或Claude Code集成的团队
希望使用自然语言查询CRM数据并管理交易、列表和任务的人员

不适合谁

没有Attio账户或API密钥的用户
需要本地数据存储或脱机操作的场景（服务器直通API，不存储数据）
希望限制为只读工具的用户（可通过设置`ATTIO_MCP_TOOL_MODE=search`实现）

所需权限

需要`ATTIO_API_KEY`环境变量（必需的API密钥）
可选的工作区ID：`ATTIO_WORKSPACE_ID`
可选的工具模式：`ATTIO_MCP_TOOL_MODE`（'full'或'search'）
可选的日志级别：`MCP_LOG_LEVEL`
可以配置默认交易阶段、所有者、货币的选项

风险与副作用

API密钥泄露风险：如果共享或暴露API密钥，他人可访问您的CRM数据
数据修改风险：默认工具模式允许写操作（创建、更新、删除），可能导致意外更改
第三方依赖风险：开源项目，需自行评估安全
配置错误风险：字段映射配置不当可能导致API调用失败

安装接入

准备工作

运行环境：Node.js 20+ · 远程托管（无需本地环境）

ATTIO_API_KEY 必填密钥 Attio API密钥（必填），在 app.attio.com/settings/api 获取。

ATTIO_ACCESS_TOKEN 可选密钥 OAuth访问令牌，替代API密钥用于OAuth集成；两者同时设置时API密钥优先。

其他可选配置项（6 个）

ATTIO_WORKSPACE_ID 可选可选的Attio工作区ID，用于工作区特定操作。

ATTIO_MCP_TOOL_MODE 可选可选，'full'（全部工具）或'search'（仅搜索工具），默认'full'。

MCP_LOG_LEVEL 可选可选，日志级别：DEBUG/INFO/WARN/ERROR，默认INFO。

ATTIO_DEFAULT_DEAL_STAGE 可选可选，新建交易的默认阶段（如'Interested'）。

ATTIO_DEFAULT_DEAL_OWNER 可选可选，新建交易的默认负责人邮箱。

ATTIO_DEFAULT_CURRENCY 可选可选，交易金额的默认货币（如USD）。

全局安装npm包：npm install -g attio-mcp
设置环境变量：export ATTIO_API_KEY="your_api_key_here"（以及可选的ATTIO_WORKSPACE_ID、ATTIO_DEFAULT_DEAL_STAGE等）
配置您的客户端：在Claude Desktop配置中添加MCP服务器条目（claude_desktop_config.json），指定命令attio-mcp和环境变量。
重启客户端。
（可选）配置字段映射文件configs/runtime/mappings/user.json以匹配您工作区的自定义字段。

claude_desktop_config.json

{
  "mcpServers": {
    "attio-mcp": {
      "command": "attio-mcp",
      "env": {
        "ATTIO_API_KEY": "your_api_key_here"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "attio-mcp": {
      "command": "attio-mcp",
      "env": {
        "ATTIO_API_KEY": "your_api_key_here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add attio-mcp -e ATTIO_API_KEY=your_api_key_here -- attio-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后运行 attio-mcp --help 测试服务器，或在客户端工具列表中确认 aaa_health_check / search_records 出现；连接成功时用 search_records 搜索公司应返回工作区数据。

常见排障

确保npm包名正确：`attio-mcp`（不是`attio-mcp-server`）
检查环境变量是否正确设置，特别是`ATTIO_API_KEY`
验证字段映射文件`user.json`是否正确，缺少映射可能导致字段无法识别
查看官方故障排除指南（TROUBLESHOOTING.md）和GitHub Issues
使用`attio-mcp --help`测试服务器安装

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查找所有50人以上、近30天未联系的AI行业公司
把John Smith从Google添加到Q1 prospects名单
搜索交易金额超过5万美元且在Q1截止的商机
为Acme公司创建一个跟进任务

工具能力 24

search_records 只读

使用通用搜索工具查找记录。

get_record_details 只读

获取记录的详细信息。

get_record_attributes 只读

获取记录的属性。

discover_record_attributes 只读

发现可用的记录属性。

search_records_advanced 只读

使用高级过滤执行复杂搜索。

search_records_by_relationship 只读

通过关系搜索记录（例如公司↔人↔交易）。

search_records_by_content 只读

按内容搜索记录（例如笔记、任务、列表）。

search_records_by_timeframe 只读

按时间范围搜索记录。

展开其余 16 个工具

batch_records 写入

批量创建、更新或删除记录。

create_record 写入

创建新记录。

update_record 写入

更新现有记录。

delete_record 破坏性

删除现有记录。

create_company 写入

创建新公司。

update_company 写入

更新现有公司。

create_deal 写入

创建新交易。

update_deal 写入

更新现有交易。

create_note 写入

为记录创建笔记。

list_notes 只读

列出记录相关的笔记。

filter_list_entries 只读

使用多模式过滤列表条目。

manage_list_entry 写入

管理列表条目（添加、删除、更新成员资格）。

get_list_entries 只读

获取列表条目。

get_record_list_memberships 只读

获取记录所属的列表成员关系。

get_record_attribute_options 只读

获取选择/状态字段的可用选项。

aaa_health_check 只读

不需要API密钥的健康检查工具。

使用场景

销售团队：查找潜在客户、更新记录、管理管线、创建跟进任务

营销团队：基于参与度创建列表、添加会议联系人

客户成功：监控续费日期、创建客户检查任务

数据操作：批量更新公司、导出数据、合并重复记录

支持客户端

Claude Desktop

Claude Web

Cursor

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

Attio MCP Server是一个全面的Model Context Protocol（MCP）服务器，为Attio CRM提供完整的表面覆盖。它使Claude和ChatGPT等AI助手能够通过自然语言直接与您的整个Attio工作区交互，管理交易、任务、列表、人员、公司、记录和笔记，而无需回退到原始API调用。该服务器提供19个通用工具、专门的列表工具和预构建的提示，适用于销售、营销、客户成功和数据操作工作流。