hmk/attio-mcp-server

分类General
作者Community
星标313
定价Free

简介

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" } } } }
## 开发

前置条件

在开始之前,请确保已安装以下内容:

  • 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-server
1. 添加上游远程仓库
sh
git remote add upstream https://github.com/hmk/attio-mcp-server.git
1. 复制 dotenv 文件
sh
cp .env.template .env
1. 安装依赖:
sh
npm install
1. 运行 watch 以保持 index.js 更新:
sh
npm run build:watch
1. 启动 model context protocol 开发服务器:
sh
dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
1. 如果开发服务器未能正确加载环境变量,请在 mcp inspector 的左侧设置 ATTIO_API_KEY

查看官方来源