Tokolaku

Tokolaku MCP サーバー

Tokolaku 向けのリモート MCP（Model Context Protocol）サーバーです。Tokolaku は、公式 WhatsApp Business API（Meta Cloud API、メッセージへの上乗せ料金なし）を基盤とする、インドネシアの中小企業向け WhatsApp ビジネスプラットフォームです。

Claude、ChatGPT、その他の MCP クライアントを Tokolaku アカウントに接続すると、AI エージェントが WhatsApp メッセージの送信、会話の閲覧、商品や注文の検索、Webhook の管理を行えます。

Endpoint : https://api.tokolaku.id/mcp
Transport: Streamable HTTP (stateless)

クイックスタート

claude.ai / ChatGPT とその他の OAuth 対応クライアント

URL を追加するだけです。キーは不要です。

1. URL https://api.tokolaku.id/mcp を使って、カスタムコネクター／MCP サーバーを追加します
2. Tokolaku アカウントでサインインし、アクセスを承認します
3. 完了です。読み取り専用ツールが 6 つ利用できます（チャンネル、受信トレイ、商品、注文）

Claude Code / Claude Desktop / SDK（API キー）

Tokolaku 開発者ダッシュボードのシークレット API キーを使用します。

{
  "mcpServers": {
    "tokolaku": {
      "type": "http",
      "url": "https://api.tokolaku.id/mcp",
      "headers": { "x-api-key": "tk_live_sk_xxx" }
    }
  }
}

ツール

API キーを使用する場合（スコープで制限されます。tools/list にはキーのスコープに応じたツールが表示されます）：

ツール	説明
send_message	公式チャンネル経由でセッションのテキストメッセージを送信します
generate_bot_reply	テナントのボットエンジンを使って AI の返信を生成します
list_channels	接続済みの公式チャンネルを一覧表示します
list_conversations / get_conversation	受信トレイを閲覧します
list_products	商品カタログを閲覧します
list_orders / get_order	注文を閲覧します（支払い状況を含む）
get_subscription	プランと利用枠の情報を取得します
list_webhooks / create_webhook / test_webhook	イベント受信用Webhookを管理します

OAuth 経由（読み取り専用のツール一式）：list_channels、list_conversations、get_conversation、list_products、list_orders、get_order。

認証

• OAuth 2.1（PKCE、動的クライアント登録、RFC 8414/9728 によるディスカバリー）— 対話型クライアント向けです。トークンはユーザーごとに発行され、読み取り専用です。
• API キー（x-api-key または Authorization: Bearer）— シークレットキーのみ使用できます。書き込みツールには、REST API と同様に課金と利用枠が適用されます。

リンク

• ドキュメントと API リファレンス：https://tokolaku.id/api-docs
• 開発者向け概要：https://tokolaku.id/developers
• WhatsApp Business API プラン（Rp99k/月、メッセージへの上乗せ料金なし）：https://tokolaku.id/whatsapp-api
• SDK：npm tokolaku-sdk · PyPI tokolaku · Packagist tokolaku/sdk

---

このリポジトリでは、ホスト型サーバーの公開メタデータ（server.json）とドキュメントを公開しています。サーバー自体は、Tokolaku が運用するマネージドサービスです。