Attio MCP Server

🚀 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 目录 中查看：

• 入门指南
  • 安装与设置
  • Claude 桌面端配置
  • 故障排除指南
• API 参考
  • API 概述
  • 人员 API
  • 公司 API
  • 列表 API
  • 备注 API
• 部署指南
  • Docker 指南
  • 安全最佳实践
• 开发文档
  • 贡献指南
  • 错误处理
  • 扩展 MCP

🤝 贡献

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

📄 许可证

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