hmk/attio-mcp-server
简介
hmk/attio-mcp-server 是一个将 Attio CRM 能力接入 AI 客户端的适配器。它通过 MCP 协议,让 Claude 等支持该标准的 AI 助手能够直接读取和管理你的 CRM 记录与笔记,而无需在多个窗口间手动同步数据。对于需要处理大量客户信息、跟进销售线索的开发者或运营人员,它可以将 AI 变为一个实时同步的“智能助理”,直接在对话界面完成数据的查询和更新。上手门槛低,只要拥有 Attio API 密钥即可快速配置,将 CRM 从静态数据库转变为 AI 可操作的动态上下文。
核心亮点
- 实现 AI 对 Attio CRM 记录的实时读写
- 无需手动导出,直接在对话中管理客户笔记
- 标准 MCP 协议,快速集成至支持的 AI 客户端
- 将 CRM 静态数据转化为 AI 可用的实时上下文
完整文档
attio-mcp-server
这是一个为 AI 原生 CRM Attio 提供的 MCP server。它允许 mcp 客户端(如 Claude)连接到 Attio API。
#### 当前能力
- [x] 读取 company records
- [x] 读取 company notes
- [x] 写入 company notes
- [ ] 其他活动
使用方法
你需要:
ATTIO_API_KEY
这是一个 *bearer token*,你可以通过 API Explorer 右侧获取,或者通过配置 OAuth 并通过 Attio API 获取。
Claude Desktop 配置json{
"mcpServers": {
"attio": {
"command": "npx",
"args": ["attio-mcp-server"],
"env": {
"ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
}
}
}
}
## 开发
前置条件
json
{
"mcpServers": {
"attio": {
"command": "npx",
"args": ["attio-mcp-server"],
"env": {
"ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
}
}
}
}在开始之前,请确保已安装以下内容:
- Node.js (推荐 v22 或更高版本)
- npm
- git
- dotenv
配置开发环境
请按照以下步骤配置开发环境:
1. Fork 仓库
- 点击本仓库右上角的 "Fork" 按钮
- 这将在你的 Github 账户下创建该仓库的副本
1. Clone 你的 Fork:
sh
git clone https://github.com/YOUR_USERNAME/attio-mcp-server.git
cd attio-mcp-serversh
git remote add upstream https://github.com/hmk/attio-mcp-server.gitdotenv 文件sh
cp .env.template .envsh
npm installwatch 以保持 index.js 更新:sh
npm run build:watchsh
dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.jsATTIO_API_KEY。