GramClawは、同じTelegramエンジンを2つの方法で提供します。カスタム自動化のためのREST APIと、AIエージェントのためのリモートMCP（Model Context Protocol）サーバーです。どちらも設定で作成するAPIキーで認証し、どちらもTelegramアカウントを健全に保つ同じアカウントごとのペース調整を尊重し、どちらも有効なサブスクリプションまたはトライアルを必要とします。
実際には、REST APIはコードのためのものです。お客様の製品から連絡先を同期したり、ユーザーがサインアップしたときにキャンペーンをトリガーしたり、会話をデータウェアハウスに流し込んだりします。MCPサーバーはエージェントのためのものです。Claude Desktop、Claude Code、Cursor、または自前のエージェントが、コードを一切書かずに、チャットの一覧表示、メッセージの読み取り、返信の送信、ブロードキャストの実行、パイプラインの管理を行うツールを手に入れます。
APIキーを作成する
- 1
設定 → APIキー を開く
キーを生成し、そのスコープを選びます。データの一覧表示や読み取りにはread、書き込みやメッセージ送信を伴うものにはsendです。キーは必要最小限のスコープに限定しましょう。
- 2
一度だけコピーする
完全なキー（gc_live_…）は作成時にのみ表示されます。シークレットマネージャーに保管してください。漏洩した場合は、設定で削除すれば、直ちに機能しなくなります。
- 3
認証する
REST：Authorization: Bearer ヘッダーとして送信します。MCP：サーバーURLのkeyパラメーターに含めます。
1分でわかるREST API
APIはプラットフォームの主要な範囲をカバーします。アカウント、チャット、メッセージ、連絡先、キャンペーン、ブロードキャスト、パイプラインのカラム、分析です。リクエストはHTTPS上のプレーンなJSONです。すべてのエンドポイントのドキュメント（各ルート、そのスコープ、リクエスト／レスポンスの例）はAPIドキュメントページにあり、機械可読なOpenAPI仕様は、コード生成やLLMへの受け渡し用に /openapi.json で提供されています。
MCPサーバーを接続する
- 1
サーバーURLをコピーする
https://gramclaw.com/api/mcp?key=gc_live_… — このキーはお客様を識別し、かつ認可します。操作できるアカウントに範囲が限定されています。
- 2
MCPクライアントに追加する
Claude Desktop、Claude Code、Cursor、その他あらゆるMCP対応クライアントが、リモートサーバーURLを受け付けます。ローカルへのインストールもプロキシも不要です。
- 3
実際の作業を依頼する
接続すると、お客様のエージェントは、チャットの検索、返信の下書きと送信、キャンペーンの開始、キャンペーン状況の確認、案件のパイプライン移動を行えます。すべての送信は、GramClawの他の部分と同じアカウントのペース調整の対象となります。
推奨される運用
- 連携ごとに1つのキーを用意し、それに応じた名前を付けましょう。そうすれば、1つを取り消しても他が壊れることはありません。
- ダッシュボードや分析処理には、読み取り専用のスコープを選びましょう。
- チームメンバーが離れたらキーをローテーションし、使わなくなったキーは削除しましょう。取り消しは即座に行われます。
- APIやMCPによる送信は、お客様の実際のアカウントからの本物のTelegramメッセージであることを忘れないでください。アプリと同じ、同意と送信量に関する判断が適用されます。