attio-mcp-server

attio-mcp-server

site icon
2025.05.10 0
TypeScriptCRMAPI 连接交流协作
attio-mcp-server 是一个为 AI 原生 CRM 平台 Attio 设计的 MCP 服务器,允许 MCP 客户端(如 Claude)连接到 Attio API。该服务器目前支持读取公司记录、读取和写入公司笔记等功能。
View on GitHub

Overview

基本能力

产品定位

attio-mcp-server 是一个为 Attio CRM 平台设计的 MCP 服务器,旨在提供与 Attio API 的连接能力。

核心功能

  • 读取公司记录
  • 读取公司笔记
  • 写入公司笔记

适用场景

  • 与 Attio CRM 平台进行数据交互
  • 通过 MCP 客户端(如 Claude)访问 Attio 数据

工具列表

  • npx: 用于运行 attio-mcp-server
  • dotenv: 用于管理环境变量

常见问题解答

  • 如何获取 ATTIO_API_KEY?可以通过 Attio API Explorer 获取 bearer token 或配置 OAuth 获取。
  • 开发服务器未正确加载环境变量时,可以在 mcp inspector 左侧手动设置 ATTIO_API_KEY

使用教程

使用依赖

  • Node.js (推荐 v22 或更高版本)
  • npm
  • git
  • dotenv

安装教程

  1. Fork 仓库
  2. 克隆你的 Fork: sh git clone https://github.com/YOUR_USERNAME/attio-mcp-server.git cd attio-mcp-server
  3. 添加上游远程仓库: sh git remote add upstream https://github.com/hmk/attio-mcp-server.git
  4. 复制 dotenv 文件: sh cp .env.template .env
  5. 安装依赖: sh npm install
  6. 运行 watch 以保持 index.js 更新: sh npm run build:watch
  7. 启动模型上下文协议开发服务器: sh dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js

调试方式

  • 确保 ATTIO_API_KEY 已正确设置
  • 检查开发服务器是否正常运行
  • 使用 mcp inspector 进行调试

许可证

该项目遵循 BSD-3-Clause 开源许可条款,请参阅 BSD-3-Clause 了解完整条款。