すべてのドキュメントを閲覧

CursorをNarwhal MCPに接続

Narwhalのホスト型Streamable HTTP MCPサーバーに、安全なBearerトークンのプレースホルダーを使ってCursorを設定します。

Cursor でホスト型 HTTP MCP サーバーを設定するファイルは .cursor/mcp.jsonです。以下の設定では、Narwhal Bearer キーの変数プレースホルダーを使用します。

Cursorを設定

設定ファイル .cursor/mcp.json をプロジェクト内またはユーザー設定内に作成するか、既存のファイルを開き、次の内容を追加します:

.cursor/mcp.json
{
  "mcpServers": {
    "narwhal": {
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NARWHAL_API_KEY}"
      }
    }
  }
}

Cursorを起動するクライアントから変数を利用できることを確認します。ファイル保存後にMCPサーバーを再起動または再読み込みします。詳しくは CursorのMCP設定ガイド で、現在のクライアントの動作を確認してください。

接続を確認

クライアントの MCP サーバー一覧を開き、 narwhal が接続済みであることを確認してください。 コマンドラインで確認するには、次を実行します: agent mcp list。

次にクライアントへ利用可能なNarwhalツールの一覧を依頼します。ツールの検出はデータクォータを消費せず、成功した各 tools/call はリクエストを1件消費します。

次を使用: メインMCPガイド で、公開ツール一覧、引数、レスポンス形式、クォータの規則を確認してください。

キーを秘密に保つ

CursorまたはVS Codeの安全な変数/入力ストレージをプレースホルダーに使用します。実際のキーを mcp.jsonに記載してコミットしたり、プロンプトに貼り付けたり、URL に含めたり、ブラウザ側のコードで公開したりしないでください。

すべてのリクエストには Authorization: Bearer ヘッダーが必要です。詳しくは 認証ガイド で、キーの保存とローテーションについて確認してください。