外部 MCP クライアントを Griptape Nodes に接続する (Connect External MCP Clients to Griptape Nodes)

Griptape Nodes は独自の組み込み MCP サーバーを実行しているため、外部のエージェント（Claude Desktop、Claude Code、Cursor、VS Code など）からエンジンを直接操作・制御できます。このページは本セクションの他のページとは逆の関係になります：Griptape Nodes が外部の MCP サーバーを消費するのではなく、ここでは Griptape Nodes 自身を MCP サーバーとして外部に公開します。

接続 URL (URL)

デフォルトでは、エンジンは以下のアドレスでリクエストを待機（リッスン）します：

http://localhost:8125/mcp/

トランスポート方式は Streamable HTTP です。末尾のスラッシュ（/）を含めることが推奨されます；サーバーは末尾スラッシュを省略したクライアントのために /mcp を /mcp/ へ自動リダイレクトします。

エンジンが起動すると、実際にバインドされたアドレスがログに出力されます。例：

INFO MCP server listening at http://127.0.0.1:8125/mcp/

設定の上書き (Overrides)

ホストおよびポートは、環境変数によって制御されます：

環境変数	デフォルト値	説明
`GTN_MCP_SERVER_HOST`	`localhost`	バインドするネットワークインターフェース。明示的に指定する場合は `127.0.0.1`、LAN 公開時は `0.0.0.0`。
`GTN_MCP_SERVER_PORT`	`8125`	TCP ポート。OS に空きポートを自動割り当てさせるには `0` を指定。
`GTN_MCP_SERVER_LOG_LEVEL`	`ERROR`	MCP サーバー用の uvicorn ログレベル。

設定されたポートがすでに使用中の場合、エンジンは OS が割り当てた空きポートへと自動フォールバックします。起動ログを確認して実際の URL を特定してください。

デフォルトではローカル専用です

エンジンはデフォルトで localhost にバインドされるため、同一マシン上のプロセスのみがアクセスできます。この MCP サーバーには認証機能がありません。到達可能なすべてのクライアントを完全に信頼できる場合を除き、0.0.0.0 にバインドしたりポートをネットワーク上に公開したりしないでください。

クライアント側の設定 (Client configuration)

Claude Code

~/.claude.json に追加します（または claude mcp add コマンドを使用）：

{
  "mcpServers": {
    "griptape-nodes": {
      "type": "streamable-http",
      "url": "http://localhost:8125/mcp/"
    }
  }
}

Cursor

グローバルアクセスの場合は ~/.cursor/mcp.json、ワークスペース固有アクセスの場合はプロジェクト内の .cursor/mcp.json に作成・追加します：

{
  "mcpServers": {
    "griptape-nodes": {
      "url": "http://localhost:8125/mcp/"
    }
  }
}

VS Code

ワークスペース内に .vscode/mcp.json を作成するか、コマンドパレットから MCP: Open User Configuration でユーザー設定ファイルを開きます：

{
  "servers": {
    "griptape-nodes": {
      "type": "http",
      "url": "http://localhost:8125/mcp/"
    }
  }
}

VS Code では（mcpServers ではなく）servers キーを使用し、"type": "http" と指定する点に注意してください。

Claude Desktop

Claude Desktop の claude_desktop_config.json は stdio サーバーのみをネイティブサポートしています。リモート/HTTP MCP サーバーに接続するには、以下のいずれかの方法をとります：

アプリ内の Settings → Connectors → Add custom connector を使用し、http://localhost:8125/mcp/ を貼り付ける、または
設定ファイル内で mcp-remote を使用して URL をラップする：

{
  "mcpServers": {
    "griptape-nodes": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8125/mcp/"]
    }
  }
}

接続の検証 (Verifying the connection)

最もシンプルな非対話的な検証方法は、MCP Inspector CLI を使用することです。エンジンは Streamable HTTP を使用するため、--transport http を渡します：

npx -y @modelcontextprotocol/inspector --cli http://localhost:8125/mcp/ \
  --transport http --method tools/list

--transport http を指定しない場合、インスペクターはデフォルトで SSE を試行し、SSE error: Non-200 status code (400) が返されます。これはエンジンが有効な MCP セッションのない SSE 形式の GET リクエストを拒否するためです。

インスペクターにはブラウザ UI も用意されています：

npx -y @modelcontextprotocol/inspector

URL フィールドに http://localhost:8125/mcp/ を貼り付け、トランスポートとして Streamable HTTP を選択します。接続が TypeError: NetworkError when attempting to fetch resource で失敗する場合、原因の多くは CORS です：エンジンの MCP サーバーは現在 Access-Control-Allow-Origin ヘッダーを出力しないため、ブラウザからのクロスオリジンフェッチがブロックされます。上記の CLI コマンドを使用するか、ブラウザセキュリティを緩和してインスペクターを実行してください。

ワークフロー構築スキルのインストール (Install the workflow-construction skill)

エンジンには、エージェントに上述の MCP ツールの操作方法（コールドスタート時のレシピ、EventRequestBatch、よくある注意点）を教える griptape-nodes-workflows スキルが同梱されています。Claude Code、Cursor、および VS Code は、agentskills.io の name + description フロントマター規則に従うスキルをネイティブに読み込むため、フォルダにファイルを配置するだけでインストールできます。

公開されている Markdown は以下にあります：

https://docs.griptapenodes.com/en/stable/skills/griptape-nodes-workflows/SKILL/index.md

どのスコープを選択する場合でも、ディレクトリ名は必ず griptape-nodes-workflows（フロントマター内の name フィールドと一致する必要がある）とし、ファイル名は必ず SKILL.md としてください。

クライアント別インストールパス

クライアント	プロジェクトスコープ	ユーザースコープ
Claude Code	`.claude/skills/griptape-nodes-workflows/SKILL.md`	`~/.claude/skills/griptape-nodes-workflows/SKILL.md`
Cursor	`.cursor/skills/griptape-nodes-workflows/SKILL.md`	`~/.cursor/skills/griptape-nodes-workflows/SKILL.md`
VS Code (Copilot)	`.github/skills/griptape-nodes-workflows/SKILL.md`	`~/.copilot/skills/griptape-nodes-workflows/SKILL.md`

Cursor と VS Code は、.agents/skills/（プロジェクト）および ~/.agents/skills/（ユーザー）も認識し、VS Code はさらに .claude/skills/ / ~/.claude/skills/ も認識します。1 つのフォルダで複数のクライアントに対応させたい場合は、~/.agents/skills/griptape-nodes-workflows/SKILL.md にスキルを配置してください。

ワンコマンドでのインストール

上記の表に合わせて DEST を調整して実行します：

DEST="$HOME/.claude/skills/griptape-nodes-workflows"
mkdir -p "$DEST" \
  && curl -fsSL https://docs.griptapenodes.com/en/stable/skills/griptape-nodes-workflows/SKILL/index.md \
       -o "$DEST/SKILL.md"

チャットで /skills と入力するか（Claude Code または VS Code）、カスタマイズメニューの Skills タブを開いて（Cursor）、正常に読み込まれたことを確認してください。