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 文件。