MCP Client:

MCP クライアント：@pinax/mcp

https://app.pinax.network の MCP サーバー互換サービスに接続するための MCP クライアントです。

使用方法

Usage: @pinax/mcp [options]

A bridge client for connecting Claude Desktop and other MCP-compatible clients to remote MCP servers.

Options:
  -V, --version              output the version number
  --remote-url <string>      Remote MCP server URL (env: REMOTE_URL)
  --access-token <string>    JWT Access Token (env: ACCESS_TOKEN)
  -v, --verbose <boolean>    Enable verbose logging (choices: "true", "false", default: false, env: VERBOSE)
  -h, --help                 display help for command

ドキュメント：https://app.pinax.network/docs/guides/mcp

エンドポイント

この MCP を使用すると、LLM は Pinax Token API が提供するデータにアクセスできます。

• MCP サーバー（Streamable HTTP）には https://mcp.pinax.network を使用します

認証

1. https://app.pinax.network でサインインします
2. キー に移動します
3. プロジェクトキーをコピーし、JWT アクセストークンを生成します

設定

環境変数（.env）

ACCESS_TOKEN=<your-jwt-token-from-app.pinax.network>
REMOTE_URL=https://mcp.pinax.network

Claude Desktop の設定

Claude Desktop の設定ファイルに追加します：

場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

設定：

{
  "mcpServers": {
    "pinax": {
      "command": "npx",
      "args": [
        "@pinax/mcp",
        "--remote-url",
        "https://mcp.pinax.network",
        "--access-token",
        "YOUR_ACCESS_TOKEN_HERE"
      ]
    }
  }
}

または、環境変数を使用します：

{
  "mcpServers": {
    "pinax": {
      "command": "npx",
      "args": ["@pinax/mcp"],
      "env": {
        "REMOTE_URL": "https://mcp.pinax.network",
        "ACCESS_TOKEN": "YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

Bun での使用（開発）

{
  "mcpServers": {
    "pinax": {
      "command": "/path/to/bun",
      "args": [
        "run",
        "/path/to/pinax-mcp/index.ts",
        "--remote-url",
        "http://localhost:8080/mcp",
        "--access-token",
        "YOUR_ACCESS_TOKEN_HERE",
        "-v",
        "true"
      ]
    }
  }
}

対応クライアント

このブリッジは、stdio トランスポートに対応するすべての MCP クライアントで動作します：

• Claude Desktop
• Cline
• Cursor
• その他の MCP 互換アプリケーション

トラブルシューティング

詳細ログを有効にする

コマンドに -v true を追加するか、環境で VERBOSE=true を設定します：

npx @pinax/mcp --remote-url https://example.com/mcp --access-token YOUR_TOKEN -v true

よくある問題

接続タイムアウト：

• ACCESS_TOKEN が有効であることを確認します
• REMOTE_URL が正しく、アクセス可能であることを確認します

認証失敗：

• https://app.pinax.network/keys で新しいアクセストークンを生成します
• トークンの有効期限が切れていないことを確認します

サーバー切断：

• 詳細なエラーメッセージについて、Claude Desktop のログを確認します
• リモートサーバーへのネットワーク接続を確認します

開発

依存関係のインストール

bun install

ローカルで実行

bun run index.ts --remote-url http://localhost:8080/mcp --access-token YOUR_TOKEN -v true

ビルド

bun build ./index.ts --outdir ./dist --target=node

アーキテクチャ

┌─────────────────┐          ┌──────────────┐          ┌─────────────────┐
│  Claude Desktop │◄──stdio─►│  MCP Bridge  │◄──HTTP──►│  Remote MCP     │
│  (or other      │          │   Client     │          │  Server         │
│   MCP client)   │          └──────────────┘          └─────────────────┘
└─────────────────┘

ライセンス

Apache 2.0