Campfire SMS

Campfire SMS MCP

エージェントにテキストメッセージを送れます。 Campfire SMS は、ホスト型の双方向 SMS ブリッジです。エージェントが回答を必要とする場合や結果が出た場合にテキストメッセージを送り、普段使っているメッセージ受信箱から SMS で返信できます。

このリポジトリを pip install したり、インストールコードなしで npx パッケージ名を使用したりしないでください。campfiresms.com から始めてください。

仕組み

• エージェントはブリッジを開き、入力が必要なときや作業が完了したときにテキストメッセージを送ります。
• スマートフォンの普段使っているメッセージ受信箱から返信できます。インストールが必要なスマートフォンアプリはありません。
• エージェントは返信を取得し、自身のモデル、ツール、権限を使って作業を続けます。Campfire SMS は、電話番号の登録、SMS の配信、認証済みメッセージキュー、ルーティングを処理します。

Campfire SMS は、ほかの人がテキストメッセージを送るための電話番号をエージェントに提供するサービスではありません。エージェントを、そのエージェントを実行しているあなたにつなぎます。

インストール（campfiresms.com 経由）

1. campfiresms.com で登録します。
2. 電話番号を認証します。カードの登録なしで、40 件の無料メッセージを利用できます。
3. アカウントからワンタイムインストールコマンドをコピーします（Add computers → Add a computer or Bot → Create install command）。

詳しい手順：campfiresms.com/install.html

ローカルエージェント

Codex、Claude Code、Grok Build、OpenCode、またはコンピューター上のその他の互換性のある MCP ホスト向けです。アカウントに表示されるコマンドを実行します。

npx -y @campfiresms/setup YOUR_INSTALLATION_CODE

• YOUR_INSTALLATION_CODE はアカウントから取得します。コマンドは一度だけ使用でき、有効期限は 10 分です。期限が切れた場合は、新しいコマンドを作成してください。
• Node.js 18+（npx を含む）と Python 3.12+ が必要です。
• セットアップにより、インストール用認証情報がローカルに保存され、検出された Codex と Grok Build の CLI が登録されます。その他のホストでは、セットアップによって表示されるコマンドを使い、campfire という名前のローカル MCP サーバーを追加してください。
• Linux または VM では、エージェントと同じ非 root ユーザーとして、Python 仮想環境内でセットアップを実行してください。sudo pip、システムの pip、--break-system-packages は使用しないでください。Linux/VM の手順をご覧ください。
• エージェントのセッションを実行したまま、コンピューターをスリープさせず、オンライン状態に保ってください。Campfire SMS は停止中のローカルセッションを起動しません。

保存済みのローカル接続を更新するには、次を実行します：npx -y @campfiresms/setup update

ホスト型 MCP

Streamable HTTP エンドポイント：

https://api.campfiresms.com/mcp

アカウントから取得するインストールごとのベアラー認証情報が必要です。Authorization: Bearer <credential> として送信してください。この認証情報がないと動作しません。URL だけを追加した場合（たとえば、ディレクトリのワンクリックインストールを使用した場合）は、HTTP 401 が返されます。

認証情報を取得するには、アカウントのインストールコマンドを --credential-only を付けて実行します（Node.js 18+ が必要です。Python や pip は不要です）。認証情報は、クライアントのセキュアな認証情報設定にのみ保存してください。

Grok Bot のクラウドルーチンを使用する例：認証情報を指定してホスト型 MCP に接続し、アクティブな webhook ルーチンを設定して、その URL とキーをアカウントの Grok Bot 24/7 wake に保存します。これで、受信したテキストメッセージをきっかけに、PC の電源がオフの場合でもルーチンを開始できます。Grok Bot の手順をご覧ください。

ツール

ツール	目的
campfire_open_bridge	認証済みの電話番号への SMS ブリッジを開く（または再利用する）
campfire_send_message	あなたにテキストメッセージを送る
campfire_check_messages	保留中の返信を取得する（確認されるまで繰り返し返されます）
campfire_ack	処理後にメッセージ ID を確認済みにする
campfire_close_bridge	セッション終了時にブリッジを閉じる

制限と安全性

• SMS で返信しても、エージェントに新しい権限が付与されることはありません。エージェントが既に持っている権限の範囲内で作業を指示できます。ネイティブの承認はエージェント内で行われます。
• SMS はエンドツーエンドで暗号化されません。パスワード、認証情報、支払い情報、その他の秘密情報をテキストメッセージで送らないでください。
• 送受信したテキストメッセージは、それぞれ1通としてカウントされます。メッセージを使い切ると、メッセージの送受信は一時停止します。料金をご覧ください。

リンク

• ウェブサイト：https://campfiresms.com
• セットアップガイド：https://campfiresms.com/install.html
• サポート：[email protected]

このリポジトリについて

このリポジトリには、参照用として以前の v0.1.1 Python コネクターのソースが含まれています。現在の @campfiresms/setup インストーラーには、保守されているコネクターが同梱されています。新規インストールの場合は、このソースではなく、上記の手順を使用してください。