适合谁
- 希望使用AI助手自动化CRM工作流、减少手动输入的Attio用户
- 需要与Claude Desktop、Cursor或Claude Code集成的团队
- 希望使用自然语言查询CRM数据并管理交易、列表和任务的人员
A
52FMRS · D
Attio MCP Server是一个功能丰富的MCP服务器，为Attio CRM提供全面的工具集，包括通用工具、列表管理和预构建提示。它适合希望将AI助手集成到CRM工作流中的用户。虽然项目非官方，但广泛文档化且活跃维护。需要API密钥，并注意数据修改权限。
Attio MCP Server是一个全面的Model Context Protocol（MCP）服务器，为Attio CRM提供完整的表面覆盖。它使Claude和ChatGPT等AI助手能够通过自然语言直接与您的整个Attio工作区交互，管理交易、任务、列表、人员、公司、记录和笔记，而无需回退到原始API调用。该服务器提供19个通用工具、专门的列表工具和预构建的提示，适用于销售、营销、客户成功和数据操作工作流。
工具能力
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
按时间范围搜索记录。
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密钥的健康检查工具。
安装接入
- 全局安装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"
}
}
}
}
选型与风险
不适合谁
- 没有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调用失败
常见排障
- 确保npm包名正确：`attio-mcp`（不是`attio-mcp-server`）
- 检查环境变量是否正确设置，特别是`ATTIO_API_KEY`
- 验证字段映射文件`user.json`是否正确，缺少映射可能导致字段无法识别
- 查看官方故障排除指南（TROUBLESHOOTING.md）和GitHub Issues
- 使用`attio-mcp --help`测试服务器安装
使用场景
销售团队：查找潜在客户、更新记录、管理管线、创建跟进任务
营销团队：基于参与度创建列表、添加会议联系人
客户成功：监控续费日期、创建客户检查任务
数据操作：批量更新公司、导出数据、合并重复记录
支持客户端
Claude Desktop完整支持
Claude Web完整支持
Cursor IDE完整支持
Claude Code (CLI)完整支持