本文へスキップ

ガイド

クライアントを接続する

Claude、ChatGPT、Codex、Cursor、VS Code、Gemini CLI、Zed、Mistral Le Chat、Copilot Studio、n8n、LangChain、Vercel SDK などの MCP クライアントから Piqline に接続します。クライアントごとにコピー用ブロックを 1 つ用意しています。

Piqline には MCP サーバーが 2 つあり、どちらも Streamable HTTP で動作します。

サーバーURL認証
フルhttps://piqline.com/api/mcpAuthorization: Bearer … ヘッダーに API キー
オープンな入口https://piqline.com/api/open/mcpなし。Piqline でできることと、その公開データ

キーは、無料アカウントの 設定 → API と MCP で作成します。共有ファイルではなく、PIQLINE_API_KEY 環境変数に保存してください。

クライアント提供元ヘッダーでのキー
Claude (claude.ai, Claude Desktop)Anthropic可
ChatGPTOpenAI不可(オープンな入口のみ)
Mistral Le ChatMistral AI可
Microsoft Copilot StudioMicrosoft可
Claude CodeAnthropic可
Codex CLIOpenAI可
Gemini CLIGoogle可
CursorAnysphere可
VS Code (GitHub Copilot)Microsoft可
ZedZed Industries可
ClineCline可
Roo CodeRoo Code可
ContinueContinue可
WindsurfCognitionリレー経由
JetBrains AI AssistantJetBrainsリレー経由
GooseBlockリレー経由
Claude API (Messages)Anthropic可
OpenAI Responses APIOpenAI可
OpenAI Agents SDKOpenAI可
Vercel AI SDKVercel可
LangChain / LangGraphLangChain可
Google ADKGoogle可
n8nn8n可
CrewAICrewAIリレー経由
LlamaIndexLlamaIndexリレー経由
mcp-remote (any local client)Open source可

アシスタントとアプリ#

Claude (claude.ai, Claude Desktop)#

設定場所: 設定 › コネクタ › カスタムコネクタを追加

サーバーの URL を貼り付け、「リクエストヘッダー」に Authorization を追加し、値を Bearer とキーを続けた文字列にします。キーがない場合は、オープンな入口の URL を「サインインなし」で使えます。

https://piqline.com/api/mcp

Team と Enterprise のプランでは、コネクタに設定したヘッダーが全メンバーで共有されます。上限を設定した専用のキーを作成してください。

出典: support.claude.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。実際のキーでの検証は、まだ行っていません。

ChatGPT#

設定場所: 設定 › アプリ › 開発者モード › 作成

ChatGPT はヘッダーでのキーを受け付けず、OAuth または認証なしだけが使えます。現時点では、キー不要のオープンな入口に接続します。フルサーバーには、Piqline アカウントでのサインインとともに対応します。

テキスト
https://piqline.com/api/open/mcp

出典: developers.openai.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。実際のキーでの検証は、まだ行っていません。

Mistral Le Chat#

設定場所: コネクタ › MCP コネクタを追加(管理者)

サーバーの URL を貼り付け、Bearer トークン認証を選んで、キーを貼り付けます。

テキスト
https://piqline.com/api/mcp

出典: docs.mistral.ai(2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの)。実際のキーでの検証は、まだ行っていません。

Microsoft Copilot Studio#

設定場所: エージェント › ツール › ツールを追加 › 新しいツール › Model Context Protocol

サーバーの URL を貼り付け、「API キー」、場所は「ヘッダー」、名前は Authorization を選びます。接続時に、Bearer とキーを続けて入力します。

テキスト
https://piqline.com/api/mcp

出典: learn.microsoft.com(2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの)。実際のキーでの検証は、まだ行っていません。

コーディングエージェントとエディター#

Claude Code#

設定場所: ターミナル

コマンドは 1 つです。--scope project を付けると .mcp.json に書き込まれ、チームで共有できます。

claude mcp add --transport http piqline https://piqline.com/api/mcp \
  --header "Authorization: Bearer $PIQLINE_API_KEY"

出典: code.claude.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。2026-11-20 に実際のキーでテスト済みです。

Codex CLI#

設定場所: ~/.codex/config.toml

Codex はキーを環境変数から読み取ります。PIQLINE_API_KEY をエクスポートしてから、サーバーを設定に追加してください。

TOML
[mcp_servers.piqline]
url = "https://piqline.com/api/mcp"
bearer_token_env_var = "PIQLINE_API_KEY"

出典: learn.chatgpt.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。実際のキーでの検証は、まだ行っていません。

Gemini CLI#

設定場所: ターミナルまたは ~/.gemini/settings.json

コマンド 1 つか、settings.json のブロックで設定します。httpUrl キーで HTTP トランスポートを選びます(url は従来の SSE を意味します)。

gemini mcp add --transport http \
  --header "Authorization: Bearer $PIQLINE_API_KEY" piqline https://piqline.com/api/mcp

出典: geminicli.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。2026-11-20 に実際のキーでテスト済みです。

Cursor#

設定場所: ~/.cursor/mcp.json または .cursor/mcp.json

このブロックは、キーを環境変数から読み取ります。

JSON
{
  "mcpServers": {
    "piqline": {
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:PIQLINE_API_KEY}" }
    }
  }
}

出典: cursor.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。実際のキーでの検証は、まだ行っていません。

VS Code (GitHub Copilot)#

設定場所: .vscode/mcp.json

VS Code は初回接続時にキーを尋ね、シークレットストアに保存します。.vscode/mcp.json 形式は、2027 年 2 月に、Claude Code 形式のルートの .mcp.json に置き換えられると告知されています。

JSON
{
  "inputs": [
    { "type": "promptString", "id": "piqline-key", "description": "Piqline API key", "password": true }
  ],
  "servers": {
    "piqline": {
      "type": "http",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer ${input:piqline-key}" }
    }
  }
}

出典: code.visualstudio.com(2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの)。実際のキーでの検証は、まだ行っていません。

Zed#

設定場所: Zed の settings.json

context_servers の下にサーバーを追加します。

JSON
{
  "context_servers": {
    "piqline": {
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

出典: zed.dev(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。実際のキーでの検証は、まだ行っていません。

Cline#

設定場所: cline_mcp_settings.json

type フィールドは必須です。ないと、Cline は従来の SSE にフォールバックします。

JSON
{
  "mcpServers": {
    "piqline": {
      "type": "streamableHttp",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

出典: docs.cline.bot(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。実際のキーでの検証は、まだ行っていません。

Roo Code#

設定場所: .roo/mcp.json

プロジェクトのファイルにサーバーを追加します。

JSON
{
  "mcpServers": {
    "piqline": {
      "type": "streamable-http",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

出典: roocodeinc.github.io(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。実際のキーでの検証は、まだ行っていません。

Continue#

設定場所: Continue の config.yaml

キーは Continue のシークレットに保存されます。

YAML
mcpServers:
  - name: piqline
    type: streamable-http
    url: https://piqline.com/api/mcp
    requestOptions:
      headers:
        Authorization: "Bearer ${{ secrets.PIQLINE_API_KEY }}"

出典: docs.continue.dev(2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの)。実際のキーでの検証は、まだ行っていません。

Windsurf#

設定場所: ~/.codeium/windsurf/mcp_config.json

Windsurf は HTTP トランスポートとヘッダーに対応しています。お使いのバージョンでこのブロックが拒否される場合は、下の mcp-remote リレーを使ってください。

JSON
{
  "mcpServers": {
    "piqline": {
      "serverUrl": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}

出典: docs.devin.ai(2026 年 11 月 20 日に確認、ヘッダーの記載なし。リレーを推奨)。実際のキーでの検証は、まだ行っていません。

JetBrains AI Assistant#

設定場所: 設定 › ツール › AI Assistant › Model Context Protocol

ドキュメントには、リモートサーバー用のヘッダーの記載がありません。下の mcp-remote リレーを使ってください。

mcp-remote リレーを参照してください。

出典: www.jetbrains.com(2026 年 11 月 20 日に確認、ヘッダーの記載なし。リレーを推奨)。実際のキーでの検証は、まだ行っていません。

Goose#

設定場所: goose configure › Add extension › Remote

サーバーの URL と Authorization ヘッダーを指定して、リモート HTTP 拡張を追加します。うまくいかない場合は、下の mcp-remote リレーを使ってください。

テキスト
https://piqline.com/api/mcp

出典: goose-docs.ai(2026 年 11 月 20 日に確認、ヘッダーの記載なし。リレーを推奨)。実際のキーでの検証は、まだ行っていません。

API とエージェントフレームワーク#

Claude API (Messages)#

設定場所: Messages API のリクエスト

API の MCP コネクタが、モデルに代わって Piqline を呼び出します。キーは authorization_token に入れます。現在のベータヘッダーは、出典のページを参照してください。

JSON
{
  "mcp_servers": [
    { "type": "url", "url": "https://piqline.com/api/mcp", "name": "piqline", "authorization_token": "piq_live_…" }
  ]
}

出典: platform.claude.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。実際のキーでの検証は、まだ行っていません。

OpenAI Responses API#

設定場所: Responses リクエストの mcp ツール

キーは headers に入れます。

JSON
{
  "type": "mcp",
  "server_label": "piqline",
  "server_url": "https://piqline.com/api/mcp",
  "headers": { "Authorization": "Bearer piq_live_…" },
  "require_approval": "never"
}

出典: developers.openai.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。実際のキーでの検証は、まだ行っていません。

OpenAI Agents SDK#

設定場所: Python

ヘッダー付きの Streamable HTTP サーバー。

Python
import os
from agents.mcp import MCPServerStreamableHttp

piqline = MCPServerStreamableHttp(params={
    "url": "https://piqline.com/api/mcp",
    "headers": {"Authorization": f"Bearer {os.environ['PIQLINE_API_KEY']}"},
})

出典: openai.github.io(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。2026-11-20 に実際のキーでテスト済みです。

Vercel AI SDK#

設定場所: TypeScript

MCP クライアントが、ツールを generateText または streamText に渡します。

TYPESCRIPT
import { createMCPClient } from "@ai-sdk/mcp";

const piqline = await createMCPClient({
  transport: {
    type: "http",
    url: "https://piqline.com/api/mcp",
    headers: { Authorization: `Bearer ${process.env.PIQLINE_API_KEY}` },
  },
});
const tools = await piqline.tools();

出典: ai-sdk.dev(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。2026-11-20 に実際のキーでテスト済みです。

LangChain / LangGraph#

設定場所: Python

Piqline のツールが LangChain のツールになります。

Python
import os
from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "piqline": {
        "transport": "http",
        "url": "https://piqline.com/api/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['PIQLINE_API_KEY']}"},
    }
})
tools = await client.get_tools()

出典: github.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。2026-11-20 に実際のキーでテスト済みです。

Google ADK#

設定場所: Python

ADK エージェント用の MCP ツールセット。

Python
import os
from google.adk.tools.mcp_tool import McpToolset, StreamableHTTPConnectionParams

piqline = McpToolset(connection_params=StreamableHTTPConnectionParams(
    url="https://piqline.com/api/mcp",
    headers={"Authorization": f"Bearer {os.environ['PIQLINE_API_KEY']}"},
))

出典: adk.dev(2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの)。実際のキーでの検証は、まだ行っていません。

n8n#

設定場所: AI エージェントの「MCP Client Tool」ノード

サーバーの URL を貼り付け、HTTP トランスポートと「Bearer」認証を選んで、キーを貼り付けます。

テキスト
https://piqline.com/api/mcp

出典: docs.n8n.io(2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの)。実際のキーでの検証は、まだ行っていません。

CrewAI#

設定場所: Python

CrewAI は Streamable HTTP で接続します。ドキュメントにヘッダーの記載はありません。mcp-remote リレーか LangChain を使ってください。

mcp-remote リレーを参照してください。

出典: docs.crewai.com(2026 年 11 月 20 日に確認、ヘッダーの記載なし。リレーを推奨)。実際のキーでの検証は、まだ行っていません。

LlamaIndex#

設定場所: Python

LlamaIndex は HTTP サーバーに接続します。ドキュメントにヘッダーの記載はありません。mcp-remote リレーを使ってください。

mcp-remote リレーを参照してください。

出典: developers.llamaindex.ai(2026 年 11 月 20 日に確認、ヘッダーの記載なし。リレーを推奨)。実際のキーでの検証は、まだ行っていません。

その他のクライアント#

mcp-remote (any local client)#

設定場所: お使いのクライアントの MCP 設定ファイル

ローカルのプロセス(stdio)としか通信できないクライアント向けです。mcp-remote が HTTP サーバーを中継します。ヘッダーの値は env に置き、引数にはスペースを入れないでください(スペースで分割するクライアントがあります)。

JSON
{
  "mcpServers": {
    "piqline": {
      "command": "npx",
      "args": ["mcp-remote", "https://piqline.com/api/mcp", "--transport", "http-only", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer piq_live_…" }
    }
  }
}

出典: github.com(2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの)。2026-11-20 に実際のキーでテスト済みです。

API についてのご質問や、このページの誤りはありませんか。 お問い合わせ.