Chatwork MCP とは、AI の席から Chatwork の部屋やメッセージを道具として読み書きできるようにする MCP サーバーです。
- 公式の MCP サーバーを Claude Code や Claude Desktop に足す書き方と、API トークンの出し方
- 道具を「拾う口」と「書く口」に分け、外の人に届く書き込みを既定で切っておく形
- API トークンを取り替えた時、走っていた席がどこで止まったかの当社の記録
公式の Chatwork MCP サーバーを席に足す
Chatwork の GitHub の組織（chatwork）が、MCP サーバーを @chatwork/mcp-server という npm の包みで配っています。席に足す時に要る物は、Chatwork の API トークンと、包みを動かす Node.js です。
| 足す先 | 書き方 |
|---|---|
| Claude Code | 端末で claude mcp add chatwork -e CHATWORK_API_TOKEN=YOUR_CHATWORK_API_TOKEN -- npx -y @chatwork/mcp-server |
| Claude Desktop（設定の JSON） | "mcpServers": { "chatwork": { "command": "npx", "args": ["@chatwork/mcp-server"], "env": { "CHATWORK_API_TOKEN": "YOUR_CHATWORK_API_TOKEN" } } } |
| HTTP で立てる形 | npx @chatwork/mcp-server --transport http --port 3000 で先に立て、席は POST /mcp に繋ぐ。トークンは環境変数ではなく、頼むたびに見出し（header）で渡す |
出典: Chatwork MCP Server（GitHub の chatwork の組織）https://github.com/chatwork/chatwork-mcp-server（2026-10-26 に開いて確かめた）。同じ頁では、HTTP で立てた形は見出しにトークンが無いと 401 を返し、CHATWORK_API_TOKEN に戻らない（第三者がサーバーの持ち主の口座で操作できないようにするため）とされています。
API トークンの出し方
Chatwork の開発者向けの文書（developer.chatwork.com/docs/getting-started・2026-10-26 に開いて確かめた）では、画面右上の利用者名を押して出るメニューから「サービス連携」を選び、左のメニューの「APIトークン」で出します。パーソナルプラン以外では、API を使うのに組織の管理者への申請が要る、とあります。
同じ開発者向けの文書の「エンドポイントについて」（developer.chatwork.com/docs/endpoints・2026-10-26 確認）には、API トークンは有効期限が無く、機能に全部触れられる物だと書かれています。期限で切れないので、取り替える時は自分で決めることになります（鍵を取り替える節）。トークンを席の会話に載せない形は Claude Code のセキュリティの頁 にまとめています。
拾う口と書く口を分ける
公式のサーバーの道具は、部屋・メッセージ・タスク・ファイル・招待リンク・コンタクト承認などの束に分かれ、全部で 31 個並んでいます（出典: github.com/chatwork/chatwork-mcp-server・2026-10-26 確認）。この中には、部屋の一覧やメッセージを読む道具と、post_room_message のように相手の画面に届く道具が一緒に入っています。同じ頁には、読むだけで動かす形や道具を個別に切る設定の記述は見当たりませんでした。
当社では、現場の AI の席が Chatwork へ返信やお知らせを勝手に書き込んだことがありました。そこで、読んで自社の記録に残す「拾う仕事」と、外の人に届く「書く仕事」を別の権限に分け、書き込みは設定 1 本で既定を切りました（社の決め 2026-09-05）。書き込みを入れるかは人が決めます。
| 口 | やる事 | 既定 | 入れる・切るを決める者 |
|---|---|---|---|
| 拾う口 | 部屋とメッセージ・ファイルを読み、自社の記録に残す | 入れておく | 席の仕事の設計で決める |
| 書く口 | 返信・お知らせ・ファイルを送るなど、外の人に届く書き込み | 切っておく（オフ） | 人 |
| 鍵（API トークン） | 拾う口・書く口の両方が使う | 席の会話に載せず、保管庫から渡す | 人（取り替える時刻も人が決める） |
出典: 社の決め 2026-09-05（拾う口と書く口の分け方・書き込みの既定）、道具の並びは github.com/chatwork/chatwork-mcp-server（2026-10-26 確認）
止める関所は、送る口の 1 か所に置く
書き込みを止める確かめを、道具を呼ぶ側の席ごとに入れると、席を足すたびに入れ忘れが出ます。当社では関所を呼ぶ側ではなく、送る口の 1 か所に置きました（社の決め 2026-09-05）。どの席がどの頼み方で呼んでも、送る口が切れていれば Chatwork には届きません。
どの MCP でも、読む道具と書く道具が同じ包みに入っていることはよくあります。GitHub の公式のサーバーには読むだけの形が在る、という違いは GitHub MCP の頁 に書いています。
鍵を取り替える時
取り替える時刻を、決まった便から外す
当社では、時計で動く便の一覧から Chatwork を使う時刻の決まった便を拾い、どの便とも前後 3 時間以上当たらない時刻を選んで取り替えました（社の実測 2026-10-21）。短い間隔で回る巡回は、取り替えの間に 1〜2 周落ちるだけと見込みました（社の実測 2026-10-21）。
走っていた席の道具は、再起動まで 401 で弾かれた
取り替えた時、MCP の Chatwork の道具は席ごとのプロセスで動き、起動の時に渡された鍵を持ったままでした。そのため、取り替える前から起きていた席は、道具を再起動するまで 401 で弾かれ、再起動で通りました（社の実測 2026-10-22）。上の表のとおり、公式の書き方でもトークンは起動の時に環境変数で渡すので、同じ形で使っているなら同じことが起きると見ておきます。一方、毎回鍵を取り直して読む巡回の仕組みは無傷でした（社の実測 2026-10-22）。
| 鍵を持つ所 | 取り替えた時に起きた事 | 止まった時間 |
|---|---|---|
| 保管庫・本番の設定・道具の設定 | 新しい鍵に書き換えた | 数秒 |
| 取り込みの仕組み | 新しい鍵に替えて動き直した | 約 50 秒 |
| 前から起きていた席の MCP の道具 | 起動の時の鍵のままで 401。道具を再起動して通った | 再起動するまで |
| 毎回鍵を取り直して読む巡回 | そのまま通った | 無し |
出典: 社の実測 2026-10-22
取り替えた後は、走っている席の Chatwork の道具を順に再起動するところまでを、取り替えの手順に入れておきます。Chatwork 以外の MCP をどう足して、仕事を丸ごと任せる AIエージェント にしていくかは MCP の一覧 と MCP の作り方 にまとめています。
よくある質問
Chatwork MCP を Claude Code に入れるコマンドは何ですか？
端末で claude mcp add chatwork -e CHATWORK_API_TOKEN=YOUR_CHATWORK_API_TOKEN -- npx -y @chatwork/mcp-server を撃ちます。トークンは Chatwork の「サービス連携」の「APIトークン」で出します（GitHub の chatwork の組織の頁・Chatwork の開発者向け文書・2026-10-26 確認）。
AI に Chatwork を読ませるだけにできますか？
公式のサーバーの頁には、読むだけで動かす設定の記述は見当たりませんでした（2026-10-26 確認）。当社では読む仕事と外の人に届く書き込みを別の権限に分け、書き込みは設定 1 本で既定を切り、送る口の 1 か所で止めています（社の決め 2026-09-05）。
組織のアカウントで API トークンが出せません。
Chatwork の開発者向け文書では、パーソナルプラン以外は API を使うのに組織の管理者への申請が要る、とされています（2026-10-26 確認）。申請が通ってから「APIトークン」の画面で出します。
API トークンを取り替えたら、Chatwork の道具が 401 を返します。
当社では、取り替える前から起きていた席の MCP の道具が起動の時の鍵を持ったままで 401 になり、道具を再起動して通りました（社の実測 2026-10-22）。取り替えた後は、走っている席の道具を再起動します。
出典
- Chatwork MCP Server（GitHub の chatwork の組織）https://github.com/chatwork/chatwork-mcp-server（2026-10-26 に開いて確かめた）
- Chatwork API「Chatwork APIへようこそ！」https://developer.chatwork.com/docs/getting-started（2026-10-26 に開いて確かめた）
- Chatwork API「エンドポイントについて」https://developer.chatwork.com/docs/endpoints（2026-10-26 に開いて確かめた）
- 社の決め 2026-09-05（拾う仕事と書く仕事の分け方・書き込みの既定・関所の置き場）
- 社の実測 2026-10-21（鍵を取り替える時刻の選び方）
- 社の実測 2026-10-22（鍵を取り替えた時に止まった所と時間）