Basecamp MCP

🚀 Basecamp MCP Server

Basecamp MCPサーバーは、Claude Codeに対してBasecamp 4 APIの完全なアクセスを提供するMCP（Model Context Protocol）サーバーです。

✨ 主な機能

• 32のツール でBasecamp 4 APIの全機能を網羅:
  • プロジェクト（一覧表示、取得、作成、更新、ゴミ箱に移動）
  • タスクリストとタスク（CRUD、完了/未完了）
  • メッセージ（一覧表示、取得、作成、更新）
  • コメント（一覧表示、作成、更新）
  • ユーザー（一覧表示、現在のユーザー取得、プロジェクトメンバー取得）
  • スケジュールエントリー（一覧表示、取得、作成、更新）
  • ドキュメント（一覧表示、取得、作成、更新）
• OAuth 2.0認証 と自動トークン更新機能
• レート制限 の処理とリトライガイダンス

📦 インストール

前提条件

• Node.js 18以上
• Basecamp 4アカウント
• Basecampから取得したOAuthアプリケーションの資格情報

セットアップ手順

1. Basecamp OAuthアプリケーションを登録する

1. https://launchpad.37signals.com/integrations にアクセスします。
2. 「Register your application」をクリックします。
3. 詳細を入力します:
   • 名前: Claude Code MCP（または任意の名前）
   • ウェブサイト: あなたのウェブサイトまたは http://localhost
   • リダイレクトURI: http://localhost:9876/callback
4. 保存し、クライアントID と クライアントシークレット をメモします。

2. アカウントIDを見つける

あなたのBasecampアカウントIDは、BasecampのURLに含まれています:

https://3.basecamp.com/YOUR_ACCOUNT_ID/...

3. 環境変数を設定する

シェルプロファイル（.bashrc, .zshrc など）に以下を追加します:

export BASECAMP_CLIENT_ID="your-client-id"
export BASECAMP_CLIENT_SECRET="your-client-secret"
export BASECAMP_ACCOUNT_ID="your-account-id"

4. MCPサーバーをビルドする

cd basecamp-mcp
npm install
npm run build

5. Claude Codeを設定する

Claude Codeの設定にMCPサーバーを追加します。プロジェクトのルートに .mcp.json を作成または編集します:

{
  "basecamp": {
    "command": "node",
    "args": ["/path/to/basecamp-mcp/dist/index.js"],
    "env": {
      "BASECAMP_CLIENT_ID": "${BASECAMP_CLIENT_ID}",
      "BASECAMP_CLIENT_SECRET": "${BASECAMP_CLIENT_SECRET}",
      "BASECAMP_ACCOUNT_ID": "${BASECAMP_ACCOUNT_ID}"
    }
  }
}

6. 権限を追加する（オプション）

Basecampツールを自動承認するには、.claude/settings.json に以下を追加します:

{
  "allow": [
    "mcp__basecamp__*"
  ]
}

💻 使用例

基本的な使用法

# すべてのプロジェクトを一覧表示する
basecamp_list_projects

# プロジェクトの詳細を取得する（他のツールのドックIDを含む）
basecamp_get_project project_id:12345

# タスクを作成する
basecamp_create_todo project_id:12345 todolist_id:67890 content:"Review PR #123" due_on:"2024-01-20"

# メッセージを投稿する
basecamp_create_message project_id:12345 message_board_id:11111 subject:"Sprint Update" content:"<p>All tasks completed!</p>"

📚 詳細ドキュメント

トラブルシューティング

"Missing BASECAMP_CLIENT_ID or BASECAMP_CLIENT_SECRET"

シェルで環境変数が設定され、エクスポートされていることを確認してください。

"Missing BASECAMP_ACCOUNT_ID"

BasecampのURL（3.basecamp.com/ の後の数字）からアカウントIDを見つけてください。

OAuthフローが完了しない

• ポート9876が使用可能であることを確認してください。
• BasecampアプリのリダイレクトURIが http://localhost:9876/callback と正確に一致していることを確認してください。

レート制限（429エラー）

サーバーは Retry-After 値を報告します。待ってから再度試してください。

トークンの保存

OAuthトークンは、制限付きのパーミッション（600）で ~/.basecamp-mcp/tokens.json に保存されます。再認証するには、このファイルを削除してClaude Codeを再起動してください。

APIリファレンス

このサーバーは Basecamp 4 API に基づいています。

利用可能なツール

プロジェクト

タスク

メッセージ

コメント

ユーザー

スケジュール

ドキュメント