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 (v18以上)
• Attio APIキー (ここから取得)

インストール

npm install attio-mcp-server

Claude Desktopの設定

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

🌐 デプロイメントオプション

• ローカル開発: 開発ガイド
• Docker: Dockerガイド
  • Docker Composeによる簡単なセットアップ
  • ヘルスチェック付き
  • 環境変数で設定可能

📚 ドキュメント

完全なドキュメントはdocsディレクトリにあります。

• はじめに

  • インストールとセットアップ
  • Claude Desktopの設定
  • トラブルシューティングガイド

• APIリファレンス

  • API概要
  • 人物API
  • 企業API
  • リストAPI
  • ノートAPI

• デプロイメント

  • Dockerガイド
  • セキュリティのベストプラクティス

• 開発

  • コントリビューションガイドライン
  • エラーハンドリング
  • MCPの拡張

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストの提出方法、問題の報告方法、改善提案方法の詳細については、コントリビューションガイドラインを参照してください。

📄 ライセンス

このプロジェクトはBSD 3条項ライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。