Warpユーザー向け

Warpのエージェントはターミナルに住む。リポジトリの地図を渡そう。

Warpのエージェントはコマンドを実行し、その出力を読みます。Maguyvaはリポジトリ全体をインデックス化してMCPで返すので、エージェントは何かが一致するまでgrepとcatを繰り返す代わりに、コードの場所を尋ねられます。

Freeプラン:リポジトリ3個, インデックス済みリポジトリ行数、最大5万行、カード不要。

~/.warp/.mcp.jsonにmcpServersエントリを1つ。URLとAuthorizationヘッダーだけです。

Warpについて知っておくこと

Warp特有の4つの事実。

// 設定ファイル

~/.warp/.mcp.json

Warpはこのグローバルファイルにあるサーバーを自動で起動します。同じJSONをSettings → Agents → MCP servers → + Addに貼り付けることもできます。

// トランスポート

URLでリモート接続

urlエントリはStreamable HTTPまたはSSEで接続します。ローカルでは何も動かず、Node.jsも不要です。

// キー

ヘッダーにそのまま記述

キーはAuthorizationヘッダーに直接書きます。コミットするプロジェクトの.warp/.mcp.jsonではなく、グローバルファイルに置いてください。

// プロジェクトファイル

自動起動しない

Warpはクローンしたリポジトリの.warp/.mcp.jsonを検出しますが、各サーバーの起動はあなたを待ちます。設定を有効にすれば、Claude CodeやCodexの設定にあるサーバーも読み込めます。

プロジェクトルールは作業の取り決め。活用しましょう。

# AGENTS.md
- 変更を完了とする前に make test を実行する。
- その場しのぎのコマンドではなく bin/ のスクリプトを使う。

WarpはプロジェクトルールをAGENTS.md(両方あればWARP.mdが優先)から読み込み、グローバルルールをどこでも適用します。用途は次のとおりです。

ビルド、テスト、デプロイのコマンド。
エージェントが何度も間違える規約。
エージェントに絶対に実行させないコマンド。

ルールはエージェントに働き方を伝えます。これから削除する環境変数を、どのサービスがまだ読んでいるかは教えられません。

ターミナルのgrepが尽きるところ

シェルのセッションが安く学べない3つのこと。

// 出力は流れていく

エージェントが実行するgrepやcatの結果は、すべて会話に入ります。200行を出力する検索は、本題に入る前にコンテキストを使い切っていきます。

// 一致は呼び出し元ではない

grepには、本物の呼び出しと、コメント、フィクスチャ、別クラスの同名メソッドを区別できません。

// シェルは毎回ゼロから始まる

新しいセッションはリポジトリについて何も知りません。Maguyvaのインデックスはすでにできているので、最初の質問からランク付きの答えが返ります。

WarpのMCPサーバーとしてのMaguyva

mcpServersエントリ1つで、Warpのエージェントが得るもの:

インデックス済みリポジトリに対する11個のツール セマンティック、構造（AST）、グラフ、テキスト検索に加え、シンボル検索、依存元、ファイル取得。
ファイルパスと行番号付きの回答 285以上の言語に対応。ターミナルのペインで読める短さです。
読み取りだけのツール Maguyvaのツールはインデックスを照会するだけです。ファイルの編集もコマンドの実行もしません。

Warpはエージェントにターミナルを与える。
Maguyvaはエージェントにコードの地図を与える。

2つのワークフロー

まず地図に聞き、それからコマンドを実行する。

// workflow 01

失敗するスクリプトを原因までたどる

warp agent> deploy.shが失敗: BUILD_IDが未設定。どこで設定している?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← 説明文

→ エージェントはci/env.shを読み込んで、デプロイを再実行します。
[exit 0]

インデックス済みの検索1回が、リポジトリ全体への再帰grepとその出力を置き換えます。

// workflow 02

起動処理を変える前に呼び出し元を確かめる

warp agent> 起動時にマイグレーションを実行するのをやめられる?

dependency_search("runMigrations", dependents)
  呼び出し元3件: server.ts, worker.ts, scripts/seed.ts

→ エージェントは3件ともリリース手順に移します。
[exit 0]

呼び出し元が変更の前に届くので、ワーカーが古いスキーマのまま起動することはありません。

Warpでのセットアップ

3ステップ。Freeプラン:リポジトリ3個, インデックス済みリポジトリ行数、最大5万行、カード不要。

// step 01

maguyva.aiでリポジトリをインデックス化

回答を評価できるよう、すでによく知っているリポジトリを選びましょう。

// step 02

~/.warp/.mcp.jsonにMaguyvaを追加

~/.warp/.mcp.json

{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

プレースホルダーを置き換えて、質問を1つしてみる

mgv_xxxxをあなたのAPIキーに置き換えて保存します。Settings → Agents → MCP serversでサーバーが動いていることを確かめ、答えをすでに知っている質問を1つしてみましょう。