Odichat

mcp-odichat

Model Context Protocol（MCP）サーバーです。Odichat の全 API（Odichat 独自機能を含む）を、Claude、ChatGPT、VS Code Copilot などの AI アシスタントで使用できる 123 個のツールとして公開します。

機能

• Odichat API の全エンドポイントをカバーする 123 個のツール
• アカウント、エージェント、連絡先、会話、メッセージ、受信箱、チームなど
• レポート（v1 および v2）、ヘルプセンター、自動化ルール、カスタム属性、カスタムフィルター
• Odichat 独自機能：カンバンボード、カンバンステップ、カンバンタスク、カンバン監査イベント、予約メッセージ
• 適切な MCP ツールアノテーション（readOnlyHint、destructiveHint、idempotentHint）
• 複数アカウントのサポート（account_id はツールごとの引数です）
• 2 種類のトランスポート：
  • stdio — ローカルサブプロセス（Claude Desktop、VS Code、および任意の MCP クライアント）
  • Streamable HTTP — リモートのホスト型サーバー（Claude Web/Desktop/Code、ChatGPT）。ステートレスです。API トークンは ?token= クエリパラメーターでリクエストごとに渡します

必要条件

• Bun v1.0+
• API アクセスが有効な Odichat インスタンス

インストール

bun install

環境変数

変数	必須	説明
ODICHAT_API_TOKEN	stdio のみ	API アクセストークン（Odichat → Profile → Access Token で確認できます）。HTTP トランスポートでは使用しません。
MCP_TRANSPORT	いいえ	ネットワークサーバーとして実行するには http を設定します。それ以外の値または未設定の場合は stdio を使用します。
PORT	いいえ	HTTP トランスポートのポートです。デフォルトは 3000 です。

HTTP モードでは、トークンは環境変数から読み込まれません。各クライアントが ?token= クエリパラメーターで独自のトークンを渡すため、サーバーはステートレスかつマルチテナントになります。

使用方法

開発環境

bun run dev

本番環境（stdio）

bun run start

本番環境（リモート HTTP サーバー）

Bun.serve() と Web 標準の Streamable HTTP トランスポートを使って、HTTP 経由でサーバーを実行します。

MCP_TRANSPORT=http PORT=3000 bun run src/index.ts

または Docker を使用します。

docker build -t mcp-odichat .
docker run -p 3000:3000 mcp-odichat

サーバーはステートレスです。データベースもセッションもありません。各リクエストには、呼び出し元の Odichat API トークンを ?token= クエリパラメーターとして含める必要があります。SSL は上流のプロキシ（Traefik など）で終端することを想定しています。

エンドポイント：

メソッド	パス	説明
POST/GET	/mcp	MCP Streamable HTTP エンドポイント
GET	/health	ヘルスチェック（ok を返します）

ホスト型サーバーへの接続

リモート MCP に対応した任意のクライアント（Claude Web/Desktop/Code、ChatGPT）で、クエリ文字列にトークンを含むサーバー URL を指定します。

https://mcp.odichat.app/mcp?token=YOUR_API_TOKEN

1. Odichat で Profile → Access Token を開き、トークンをコピーします。
2. 上記の URL（トークンを含む）を、AI クライアントの MCP サーバー URL として追加します。

ローカル（stdio）クライアントの設定

Claude Desktop の設定

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "odichat": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-odichat/src/index.ts"],
      "env": {
        "ODICHAT_API_TOKEN": "your-api-token"
      }
    }
  }
}

VS Code の設定

.vscode/mcp.json に追加します。

{
  "servers": {
    "odichat": {
      "command": "bun",
      "args": ["run", "${workspaceFolder}/src/index.ts"],
      "env": {
        "ODICHAT_API_TOKEN": "your-api-token"
      }
    }
  }
}

ChatGPT の設定

ChatGPT は HTTP 経由でリモート MCP サーバーに接続します。上記のホスト型サーバーへの接続を参照してください。

利用可能なツール（123 個）

アカウント（2 個）

account_get、account_update

エージェントボット（5 個）

agent_bots_list、agent_bots_create、agent_bots_get、agent_bots_update、agent_bots_delete

エージェント（4 個）

agents_list、agents_create、agents_update、agents_delete

監査ログ（1 個）

audit_logs_list

自動化ルール（5 個）

automation_rules_list、automation_rules_create、automation_rules_get、automation_rules_update、automation_rules_delete

Canned Responses (4)

canned_responses_list, canned_responses_create, canned_responses_update, canned_responses_delete

Contacts (11)

contacts_list, contacts_create, contacts_get, contacts_update, contacts_delete, contacts_conversations, contacts_search, contacts_filter, contacts_create_contact_inbox, contacts_contactable_inboxes, contacts_merge

Contact Labels (2)

contact_labels_list, contact_labels_set

Conversations (12)

conversations_meta, conversations_list, conversations_create, conversations_filter, conversations_get, conversations_update, conversations_toggle_status, conversations_toggle_priority, conversations_set_custom_attributes, conversations_get_labels, conversations_set_labels, conversations_reporting_events

Conversation Assignments (1)

conversation_assignments_assign

Messages (3)

messages_list, messages_create, messages_delete

Custom Attributes (5)

custom_attributes_list, custom_attributes_create, custom_attributes_get, custom_attributes_update, custom_attributes_delete

Custom Filters (5)

custom_filters_list, custom_filters_create, custom_filters_get, custom_filters_update, custom_filters_delete

Help Center (5)

help_center_portals_list, help_center_portals_create, help_center_portals_update, help_center_categories_create, help_center_articles_create

Inboxes (10)

inboxes_list, inboxes_get, inboxes_create, inboxes_update, inboxes_get_agent_bot, inboxes_set_agent_bot, inbox_members_list, inbox_members_create, inbox_members_update, inbox_members_delete

Integrations (4)

integrations_list_apps, integrations_create_hook, integrations_update_hook, integrations_delete_hook

Profile (1)

profile_get

Reports (9)

reports_account_overview, reports_account_summary, reports_agent_summary, reports_conversation_metrics, reports_v2_overview, reports_v2_agents, reports_v2_inboxes, reports_v2_teams, reports_v2_labels

Teams (9)

teams_list, teams_create, teams_get, teams_update, teams_delete, team_members_list, team_members_add, team_members_update, team_members_delete

Webhooks (4)

webhooks_list, webhooks_create, webhooks_update, webhooks_delete

Kanban Boards (6) — [Odichat]

kanban_boards_list, kanban_boards_create, kanban_boards_get, kanban_boards_update, kanban_boards_delete, kanban_boards_update_agents

Kanban Steps (5) — [Odichat]

kanban_steps_list, kanban_steps_create, kanban_steps_get, kanban_steps_update, kanban_steps_delete

Kanban Tasks (6) — [Odichat]

kanban_tasks_list, kanban_tasks_create, kanban_tasks_get, kanban_tasks_update, kanban_tasks_delete, kanban_tasks_move

Kanban Audit Events (2) — [Odichat]

kanban_audit_events_list, kanban_audit_events_get

Scheduled Messages (4) — [Odichat]

scheduled_messages_list, scheduled_messages_create, scheduled_messages_update, scheduled_messages_delete

Development

# Run tests
bun test

# Lint & format
bun run lint
bun run format

# Type check
bun run build-check

# Full check (lint + type-check + tests)
bun run check

License

MIT