JinDaGe - attio-mcp-server MCP Details

article

README

🚀 Attio MCP Server

Attio MCP Server 是专为 AI 原生 CRM Attio 打造的模型上下文协议（MCP）服务器。该服务器能让 Claude 等 AI 助手直接与你的 Attio 数据进行交互，实现对话式 AI 与 CRM 的无缝集成。

✨ 主要特性

全面的 Attio API 支持

公司信息：支持搜索公司、查看公司详情以及管理公司备注。
人员信息：支持通过邮箱或电话搜索人员、查看人员详情以及管理人员备注。
列表信息：支持查看列表、管理列表条目以及添加或移除记录。
记录操作：支持创建、读取、更新记录，删除功能即将推出。
任务管理：支持创建、更新任务，并将任务与记录关联。

增强功能

强大的错误处理：提供详细的错误信息，便于排查问题。
自动重试机制：采用指数退避算法，确保请求的可靠性。
输入验证：对输入进行验证，避免常见错误。
标准化响应格式：统一响应格式，便于集成和使用。

💻 使用示例

基础用法

向 Claude 询问关于 Attio 数据的自然语言问题：

"Find all technology companies in our CRM"
"Add a note to Acme Corporation about our recent product demo"
"Show me all contacts from Microsoft who were added this month"
"Add Sarah Johnson's new phone number: +1-555-123-4567"

🚀 快速开始

前提条件

Node.js（版本 18 或更高）
Attio API 密钥（点击获取）

安装

npm install attio-mcp-server

Claude 桌面端配置

{
  "mcpServers": {
    "attio": {
      "command": "npx",
      "args": ["attio-mcp-server"],
      "env": {
        "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
      }
    }
  }
}

🌐 部署选项

本地开发：开发指南
Docker 部署：Docker 指南
- 支持使用 Docker Compose 轻松部署。
- 包含健康检查功能。
- 可通过环境变量进行配置。

📚 详细文档

完整的文档可在 docs 目录中查看：

🤝 贡献

欢迎贡献代码！请参考贡献指南了解如何提交拉取请求、报告问题和提出改进建议。

📄 许可证

本项目采用 BSD 3-Clause 许可证，详情请参阅 LICENSE 文件。

attio-mcp-server