attio-mcp-server

attio-mcp-server

これは、AIネイティブなCRMであるAttio向けのMCPサーバーです。MCP クライアント（Claude など）を Attio API に接続できます。

現在の機能

• Company API
  • 会社の検索
  • 会社の詳細の読み取り
  • 会社のメモの読み取り
  • 会社のメモの作成
• People API
  • 人の検索
  • 人の詳細の読み取り
  • 人のメモの読み取り
  • 人のメモの作成
• Lists API
  • すべてのリストの取得
  • リストの詳細の取得
  • リストのエントリーの取得
  • リストへのレコードの追加
  • リストからのレコードの削除
• Tasks API
• Records API

使用方法

以下が必要です。

• ATTIO_API_KEY

これは ベアラートークン として使用します。API Explorer の右側から取得するか、OAuth を設定して Attio API 経由で取得できます。

Claude Desktop の設定

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

ローカルで開発する場合は、npm link を使用できます。

# In the attio-mcp directory
npm run build && npm link

# In your Claude Desktop configuration
# Change the command to use the linked version
{
  "mcpServers": {
    "attio": {
      "command": "node",
      "args": ["PATH_TO_YOUR_REPO/dist/index.js"],
      "env": {
        "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
      }
    }
  }
}

開発

前提条件

始める前に、以下がインストールされていることを確認してください。

• Node.js（v18 以降を推奨）
• npm
• git
• dotenv
• Docker と Docker Compose（任意、コンテナ化された開発に使用）

開発環境のセットアップ

開発環境をセットアップするには、以下の手順に従ってください。

1. リポジトリをフォークします

   • このリポジトリの右上にある「Fork」ボタンをクリックします
   • Github アカウントの下に、自分用のリポジトリのコピーが作成されます

2. フォークをクローンします：

   git clone https://github.com/YOUR_USERNAME/attio-mcp.git
   cd attio-mcp
   

3. アップストリームのリモートを追加します

   git remote add upstream https://github.com/kesslerio/attio-mcp.git
   

4. dotenv ファイルをコピーします

   cp .env.template .env
   

5. 依存関係をインストールします：

   npm install
   

6. index.js を最新の状態に保つため、watch を実行します：

   npm run build:watch
   

7. Model Context Protocol 開発サーバーを起動します：

   dotenv npx @modelcontextprotocol/inspector node ./dist/index.js
   

8. 開発サーバーで環境変数が正しく読み込まれない場合は、mcp inspector の左側で ATTIO_API_KEY を設定してください。

Docker のサポート

Attio MCP Server は Docker コンテナでも実行できます。これにより、デプロイが簡単になり、異なる環境間で一貫性を保てます。

Docker イメージのビルド

# Build using the provided script
./scripts/docker-build.sh

# Or build with custom name and tag
./scripts/docker-build.sh --name my-attio-mcp --tag v1.0.0

Docker Compose での実行

1. .env ファイルで環境変数を設定します：

   ATTIO_API_KEY=your_api_key_here
   

2. Docker Compose を使用してコンテナを起動します：

   docker compose up -d
   

3. ログを確認します：

   docker compose logs -f
   

4. コンテナを停止します：

   docker compose down
   

Docker を直接使用した実行

docker run -p 9876:3000 \
  -e ATTIO_API_KEY=your_api_key_here \
  --restart unless-stopped \
  --name attio-mcp-server \
  attio-mcp-server:latest

Claude 用の Docker 設定

Docker 化された Attio MCP Server を Claude で使用するには：

{
  "mcpServers": {
    "attio": {
      "url": "http://localhost:9876"
    }
  }
}

このサーバーは、一般的なサービスとの競合を避けるため、外部向けポートとして 9876 を使用するよう設定されています。必要に応じて、docker-compose.yml ファイルでこのポートを変更できます。

Docker ヘルスチェック

Docker コンテナには、サーバーの状態を監視するヘルスチェックが含まれています。以下のコマンドでヘルス状態を確認できます：

docker ps -a