Chip MCP

Chip MCP

コーディングエージェントのためのプロジェクトメモリー、タスク、Telegram 通知。

Русская версия · chip-ai.digital/mcp

Chip は Telegram 上で動作するアシスタントです。この MCP サーバーを使うと、IDE エージェント（Claude Code、Cursor など、MCP に対応するもの）を同じアカウントに接続できます。昨日決めたこと、前回のセッションでエージェントが書いたメモ、スマートフォンから割り当てたタスクが、次のセッションでコンテキストウィンドウが空の状態から始まっても、すべて残っています。

言語に関する注意。 Chip はロシア語の製品です。ツールの応答はロシア語で、料金はルーブル建てです。どの国からでも利用できますが、ロシア語を読めない場合、応答は役に立ちません。

利用するメリット

プロジェクトに戻る際のトークン数が、2538 から 63 に減ります。 エージェントは whats_new を呼び出し、プロジェクト全体を再び読み込むのではなく、前回の訪問以降に変更された内容だけを取得します。実際の tiktoken o200k_base によるカウントを使い、2026-09-10 に実際の成熟したプロジェクトを対象に測定した値です。推定値ではありません。

シナリオ	前	後
プロジェクトへの初回訪問	2538 トークン	2284 トークン
変更がない状態で再訪	2538 トークン	63 トークン
1 日分の編集後に再訪	2538 トークン	295 トークン

読み取り専用トークンなら、ツール一覧の取得コストも抑えられます。 最初の呼び出し前に、各セッションでツール一覧の分のトークンを消費します。27 個のツールでは 2905 トークン、読み取り専用の 11 個では 1155 トークンです。エージェントがプロジェクトを読み取るだけなら、read トークンを発行して、セッションごとに 1750 トークンを節約できます。

エージェントから連絡を受け取れます。 長時間のビルドが完了すると、notify_me が Telegram にメッセージを送信します。ask_user はボタン付きで質問し、check_confirmation は後から回答を取得します。これにより、単独で作業するエージェントは推測する代わりに、人間の判断を待つことができます。

インストール

無料アカウントが必要です。Telegram で @ChipAI_robot を開き、ミニアプリ → Chip MCP の順に進み、トークン（chip_mcp_…）を発行します。エージェントに参照だけをさせ、変更はさせたくない場合は、read を選びます。

Claude Code

claude mcp add --transport http chip https://chip-ai.digital/mcp --header "Authorization: Bearer chip_mcp_YOUR_TOKEN"

Cursor — ~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）：

{
  "mcpServers": {
    "chip": {
      "url": "https://chip-ai.digital/mcp",
      "headers": { "Authorization": "Bearer chip_mcp_YOUR_TOKEN" }
    }
  }
}

url と headers を含む mcpServers エントリーに対応する他のクライアントも、同じように使えます。詳しくは docs/clients.md をご覧ください。

その後、エージェントに whats_new から開始するよう伝えてください。サーバー独自の指示にも記載されているため、ほとんどのエージェントは指示しなくても実行します。

Claude Code プラグイン

Claude Code では、設定を手作業で組み立てなくても、サーバー、セッションの手順、2 つのコマンドをまとめてインストールできます。

export CHIP_MCP_TOKEN=chip_mcp_YOUR_TOKEN
claude plugin marketplace add zapret-digital/chip-mcp
claude plugin install chip@chip-ai

トークンが保存されるのは CHIP_MCP_TOKEN だけです。プラグインファイルにも、.chip.json にも書き込まれることはありません。

プラグインで追加されるもの：

• https://chip-ai.digital/mcp/ を接続先とする chip MCP サーバー。接続先はプラグイン内に固定されており、環境変数で変更することはできません。
• /chip:start と /chip:finish。プロンプトを表示できないクライアント向けに、サーバーの start および finish プロンプトと同じセッションの手順を提供します。
• 3 つのフック。セッション開始時にプロジェクトの差分をコンテキストに追加し、コンテキストの圧縮前とセッション終了時に、エージェントに要約を保存するよう促します。

フックがプロジェクトを識別できるよう、リポジトリのルートに .chip.json が必要です。

{ "project_id": 12 }

ミニアプリから、プロジェクト設定の 「Правила для IDE-агента」 を開き、AGENTS.md の隣からファイルを送信してください。Telegram は添付ファイル名の先頭のドットを削除するため、保存後にファイル名を .chip.json に戻してください。このファイルがなくてもフックは動作せず、セッション開始時にこのリポジトリには .chip.json がないことを示すメッセージが 1 行表示されるだけです。プラグインは引き続き動作しますが、セッションは差分なしで開始されます。

フックによってセッションがブロックされることはありません。トークンやネットワークがなくても、あるいは python3 や curl がなくても、起動に失敗する代わりに説明が 1 行表示されます。

ローカル開発の場合： CHIP_MCP_URL で変更できるのは フックの接続先のみで、本番アドレスまたはループバックのスタンド（http://127.0.0.1:PORT/mcp/）に限られます。それ以外は拒否されます。MCP チャネルはこの変数を無視するため、.claude/settings.json を通じてリポジトリがトークンを独自のホストに送信することはありません。

ツール

27 個のツールがあります。read トークンでは read の 11 個を利用でき、full トークンではすべて利用できます。

ツール	アクセス	引数
add_note	書き込み	project_id、text、kind
add_task	書き込み	project_id、text
archive_project	書き込み	project_id
ask_user	書き込み	question、options
attach_file	書き込み	filename、size_bytes
check_confirmation	書き込み	ask_id
complete_task	書き込み	task_id、result
create_project	書き込み	name
finalize_upload	書き込み	upload_id
generate_image	書き込み	prompt、project_id
get_project_context	読み取り	project_id、depth
get_project_map	書き込み	project_id
list_files	読み取り	project_id
list_projects	読み取り	—
list_tasks	読み取り	project_id
notify_me	書き込み	text、upload_id
read_journal	読み取り	project_id、offset
read_map_section	読み取り	project_id、section
read_project_dialog	読み取り	project_id、session_id
read_project_file	読み取り	project_id、filename、page
rename_project	書き込み	project_id、name
save_session_summary	書き込み	project_id、text
search_project	読み取り	query、project_id、kind、since
set_reminder	書き込み	text、when
upload_project_file	書き込み	project_id、filename、size_bytes、content
whats_new	読み取り	project_id、since、session
whoami	読み取り	—

get_project_map は目次を読み取りますが、意図的に write として記載しています。取得時にプロジェクトマップも更新するため、読み取り専用トークンでは利用できません。read_map_section は副作用なく、単一の項目を読み取ります。

機械可読形式：spec.json。サーバー独自のツールレジストリから生成されています。詳しくは以下をご覧ください。

サーバーが確認できること、できないこと

• ファイルシステムにはアクセスできません。 エージェントが引数として明示的に渡した内容だけを受け取ります。リポジトリをスキャンすることはありません。
• 呼び出しの引数と結果はログに記録されません。 使用ログに保存されるのは、ツール名、所要時間、成功フラグだけです。それ以外は記録されません。
• read トークンでは書き込みできません。 ツール一覧から隠すだけでなく、呼び出し自体で制限が適用されます。
• トークンは SHA-256 として保存されます。 生の値が表示されるのは、発行時の一度だけです。
• ツール一覧の取得にはトークンが不要なため、ディレクトリからこのサーバーをインデックスできます。実際の呼び出しにはトークンが必要です。

仕様を自分で検証する

このリポジトリの spec.json は稼働中のサーバーのツールレジストリから生成されるため、実態とひそかに食い違うことはありません。本番環境の内容と自分で照合できます。

./scripts/verify.sh

コミット済みの仕様と https://chip-ai.digital/mcp/spec.json を比較します。

料金

接続は無料です。自分のプロジェクトの読み取りも無料です。書き込み、Telegram メッセージ、画像生成には Chip プランに基づく従量課金が適用されます。上限に達すると、ツールがエージェントに通知し、対処方法を伝えます。プランは Telegram ボットで確認できます。

リンク

• ランディングページとドキュメント
• Telegram ボット
• ライブ仕様

ライセンス

このリポジトリの内容（仕様、ドキュメント、スクリプト）には MIT ライセンスが適用されます。Chip サービス自体はプロプライエタリです。