エージェントを接続する

接続に必要なのは 3 つです。Studio でエージェント連携をオンにすること、エンドポイントをエージェントの設定に追加すること、エージェントがスキルを探す場所にスキルを置くことです。

エージェント連携をオンにする

エージェントメニュー

プロジェクトのウィンドウのメニューバーにはエージェントメニューがあります。

一時停止、追従、ログについてはエージェントでゲームを作るで説明しています。

エージェントに Studio を追加する

以下のクライアントはいずれも、サーバーを narraleaf という名前で登録します。例の <PORT> と <TOKEN> には、アドレスとアクセストークンの値を入れます。

Claude Code

設定をコピー → Claude Code でコマンドが得られます。ターミナルで一度だけ実行します。

claude mcp add --scope user --transport http narraleaf http://127.0.0.1:<PORT>/mcp --header "Authorization: Bearer <TOKEN>"

--scope user を付けると、サーバーはすべてのフォルダーで使えるようになり、ターミナルがどのフォルダーにあってもゲーム制作を頼めます。付けない場合、サーバーはコマンドを実行したフォルダーにしか存在しません。claude mcp list、または Claude Code の中で /mcp を実行して確認します。

ゲームを 1 本作るには 100 回以上のツール呼び出しが必要で、Claude Code は既定で呼び出しのたびに確認を求めます。最初の確認で narraleaf のツールに Yes, and don't ask again を選ぶか、~/.claude/settings.json で事前に許可します。

{ "permissions": { "allow": ["mcp__narraleaf"] } }

エージェントが何かを変更できるかどうかは、引き続き Studio のスイッチが決めます。一時停止も同じように効きます。

Claude Desktop

Claude Desktop は設定ファイルからローカルのプログラムを起動します。Studio 自身がそのプログラムになれます。--mcp-stdio を付けて起動された Studio はウィンドウを開かず、接続を起動中の Studio に転送します。

設定をコピー → stdio で、Studio のパスが入ったエントリーが得られます。

{
  "mcpServers": {
    "narraleaf": {
      "command": "/Applications/NarraLeaf Studio.app/Contents/MacOS/NarraLeaf Studio",
      "args": ["--mcp-stdio"]
    }
  }
}

パスは Studio 自身の実行ファイルです。

• macOS: アプリケーションフォルダーに置いた場合は /Applications/NarraLeaf Studio.app/Contents/MacOS/NarraLeaf Studio
• Windows: インストール先フォルダーの NarraLeaf Studio.exe。JSON ではバックスラッシュを 2 つずつ書きます。コピーしたエントリーはすでにそうなっています
• Linux: AppImage ファイルそのもの

このエントリーを claude_desktop_config.json（Claude Desktop の Settings → Developer → Edit Config）にマージし、Claude Desktop を再起動します。

このエントリーにトークンは含まれません。ブリッジはアドレスとトークンを毎回 Studio の設定から読み取るので、トークンを変更したりポートを変えたりしても使い続けられます。Studio が起動していなければ、ブリッジが Studio を起動し、エンドポイントが使えるようになるまで最大 1 分待ちます。エージェント連携がオフの場合は、どのリクエストにも、オンにする場所を示すメッセージを返します。

ブリッジが合わない場合は、サードパーティの npm パッケージ mcp-remote（Node.js が必要）でも同じことができます。

{
  "mcpServers": {
    "narraleaf": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:<PORT>/mcp", "--header", "Authorization:${NARRALEAF_AUTH}"],
      "env": { "NARRALEAF_AUTH": "Bearer <TOKEN>" }
    }
  }
}

URL でカスタムコネクターを追加できる Claude Desktop なら、そこにアドレスとトークンを入れることもできます。

opencode

設定をコピー → opencode でブロックが得られます。作業フォルダーの opencode.json、またはすべてのフォルダーで使うなら ~/.config/opencode/opencode.json にマージします。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "narraleaf": {
      "type": "remote",
      "url": "http://127.0.0.1:<PORT>/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

opencode mcp list で確認します。

Codex CLI

~/.codex/config.toml に追加します。

[mcp_servers.narraleaf]
url = "http://127.0.0.1:<PORT>/mcp"
http_headers = { "Authorization" = "Bearer <TOKEN>" }

トークンをファイルに書きたくない場合は、シェルで NARRALEAF_TOKEN として export し、http_headers の代わりに bearer_token_env_var = "NARRALEAF_TOKEN" と書きます。codex mcp list、または Codex の中で /mcp を実行して確認します。

Cursor

作業フォルダーの .cursor/mcp.json、またはすべてのフォルダーで使うなら ~/.cursor/mcp.json として保存し、Cursor Settings → MCP でサーバーを有効にします。

{
  "mcpServers": {
    "narraleaf": {
      "url": "http://127.0.0.1:<PORT>/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json、または作業フォルダーの .gemini/settings.json にマージします。

{
  "mcpServers": {
    "narraleaf": {
      "httpUrl": "http://127.0.0.1:<PORT>/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  },
  "context": { "fileName": ["AGENTS.md", "GEMINI.md"] }
}

context.fileName によって Gemini CLI は AGENTS.md を読み、そこからスキルにたどり着きます。Gemini CLI の中で /mcp を実行して確認します。

その他のクライアント

ローカルのプログラムしか起動できないクライアントでは、Claude Desktop のエントリーと同じように --mcp-stdio を付けて Studio を起動するか、mcp-remote などのブリッジを使います。

スキルを入れる

エージェント → Agent Skill を書き出す… は、選んだフォルダーに NarraLeaf-Skills という名前のフォルダーを書き出します。同じ名前のファイルは置き換えられ、フォルダー内のほかのファイルはそのまま残ります。

スキルは narraleaf-make-game フォルダーです。SKILL.md だけでなくフォルダーごと、エージェントがスキルを探す場所にコピーします。

AGENTS.md を読むエージェント（opencode、Codex、Cursor、上記の設定をした Gemini CLI など）は、NarraLeaf-Skills の中で起動すれば自分でスキルを見つけます。

隣の narraleaf-port-renpy は、ソースのある Ren'Py のゲームを移植するためのスキルです。Ren'Py のゲームを移植するを参照してください。narraleaf-make-game を土台にしているので、両方を同じ方法で入れます。サーバーはこれをガイドとして提供しないため、エージェントはフォルダーから読み取ります。

スキルがない場合

サーバー自身がガイドを提供するので、スキルを入れていないエージェントもガイドを受け取れます。

• make_game プロンプトは、MCP のプロンプトを表示するクライアントで作業全体を始めます。多くは /make_game のようなスラッシュコマンドで、Claude Code では /mcp__narraleaf__make_game です。
• agent_guide ツールは任意の章を返します。workflow、story-format、ui-format、blueprint-format、ui-design、script-adaptation、layered-sprites、verify-and-ship、localization-and-voice、troubleshooting があります。
• 同じ章は MCP リソース narraleaf://guide/<chapter> としても提供されます。

どの MCP クライアントでも、最初のメッセージとして次の文が使えます。

Use the NarraLeaf Studio tools. Call agent_guide with chapter "workflow" and follow it to make my game.