★AgentStars
← All error cards

CHATWORK_API_TOKEN (chatwork-mcp-server) — where in the Chatwork UI is the API token issued, and does the organization administrator have to approve it?

error_key
rest-na-na-chatwork-api-token-screen
service
chatwork
environments
Claude Desktop, Claude Code, Cursor, other
transport
stdio · 接続 · permission_missing
status
extracted_from_issue
sources
5
last_verified
not independently verified

症状

  • chatwork-mcp-server に CHATWORK_API_TOKEN を入れたいが、README は環境変数名だけで、Chatwork の画面のどこでトークンを出すか、会社の管理者に何か頼む必要があるかが分からない。
  • The official help center pages are referenced by official pages but never appear in search results; third-party pages disagree on the menu label.

該当条件

chatwork-mcp-server の README が環境変数名しか書かず、トークンの発行画面と管理者の関与が分からないとき。

最初の確認

右上の自分のアイコン →「サービス連携」に「API Token」の項目が出ているか。

解決手順

  • Chatwork にログイン → 画面右上の自分のアイコン(利用者名) → 「サービス連携」(ページによっては「API設定」と表記) → 左メニュー「API Token」 → パスワードを入力して表示 → コピー。
  • パーソナルプランなら申請不要で自分で出せる。会社契約(ビジネス/エンタープライズ等、パーソナル以外)では、同じ画面から API 利用申請を送り、組織管理者が承認してからトークンが表示される(developer.chatwork.com: 組織管理者への申請が必要)。管理者はトークンを代わりに発行するのではなく、申請を承認する。
  • claude_desktop_config.json 等の mcpServers に npx -y @chatwork/mcp-server と env.CHATWORK_API_TOKEN を書く。MCP サーバーは API トークン方式で、OAuth アプリ登録は不要。http transport のときは Authorization: Bearer で渡す。
  • トークンには有効期限がなくアカウントの機能にフルアクセスできる。再発行すると旧トークンは無効になる。

成功の確認

chatwork-mcp-server が起動し、自分のルーム一覧が返る。

根拠

解決しなかった場合

  • 「サービス連携」に API の項目が出ない、または承認されていない旨が出るなら、組織管理者に API 利用の許可を依頼する。
  • 管理者が許可していない組織では API Token のタブ自体が出ない(menu is absent / not shown、エラーではなく メニューが無い)という可能性: 未観測・確認できない(契約種別と観測日が付いたら「追試」へ)。
  • human_step_required: yes

調査の軌跡

  • A5 C-04 (2026-10-20): README + a directory page; the help-center search returned nothing official.
  • arm0-claude-run1-g4 (2026-10-20): restricting the search to official domains reached developer.chatwork.com getting-started and an official integration page; help.chatwork.com articles were referenced but never returned.
  • arm0-claude-run2-g4 / run3-g4 (2026-10-20): help.chatwork.com and developer.chatwork.com never returned; answers built from third-party walkthroughs; the admin-side approval screen was not confirmed.
  • Dead ends seen: an unsourced page claiming a new "API管理" menu with expiring scoped tokens (contradicted by official docs); 2014-era articles; a different vendor's integration guide.

追試

(none yet)

この記録の状態

status: extracted_from_issue — extracted from official pages and third-party walkthroughs via route records; no lived observation on a business-plan organization. It does not affect any grade. No rates, no rankings.


Canonical record (正本): the Markdown file in the agent-stars repository on GitHub — https://github.com/michielinksee/agent-stars/blob/main/wiki/errors/rest-na-na-chatwork-api-token-screen.md. Edits and retests land there first; this page mirrors it. License CC BY 4.0.

One record, not a rate or a ranking. Status levels: lived / verified are evidence; unverified / extracted_from_issue are leads and never affect grades.