ガイド
クライアントを接続する
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/mcp | Authorization: Bearer … ヘッダーに API キー |
| オープンな入口 | https://piqline.com/api/open/mcp | なし。Piqline でできることと、その公開データ |
キーは、無料アカウントの 設定 → API と MCP で作成します。共有ファイルではなく、PIQLINE_API_KEY 環境変数に保存してください。
| クライアント | 提供元 | ヘッダーでのキー |
|---|---|---|
| Claude (claude.ai, Claude Desktop) | Anthropic | 可 |
| ChatGPT | OpenAI | 不可(オープンな入口のみ) |
| Mistral Le Chat | Mistral AI | 可 |
| Microsoft Copilot Studio | Microsoft | 可 |
| Claude Code | Anthropic | 可 |
| Codex CLI | OpenAI | 可 |
| Gemini CLI | 可 | |
| Cursor | Anysphere | 可 |
| VS Code (GitHub Copilot) | Microsoft | 可 |
| Zed | Zed Industries | 可 |
| Cline | Cline | 可 |
| Roo Code | Roo Code | 可 |
| Continue | Continue | 可 |
| Windsurf | Cognition | リレー経由 |
| JetBrains AI Assistant | JetBrains | リレー経由 |
| Goose | Block | リレー経由 |
| Claude API (Messages) | Anthropic | 可 |
| OpenAI Responses API | OpenAI | 可 |
| OpenAI Agents SDK | OpenAI | 可 |
| Vercel AI SDK | Vercel | 可 |
| LangChain / LangGraph | LangChain | 可 |
| Google ADK | 可 | |
| n8n | n8n | 可 |
| CrewAI | CrewAI | リレー経由 |
| LlamaIndex | LlamaIndex | リレー経由 |
| mcp-remote (any local client) | Open source | 可 |
アシスタントとアプリ#
Claude (claude.ai, Claude Desktop)#
設定場所: 設定 › コネクタ › カスタムコネクタを追加
サーバーの URL を貼り付け、「リクエストヘッダー」に Authorization を追加し、値を Bearer とキーを続けた文字列にします。キーがない場合は、オープンな入口の URL を「サインインなし」で使えます。
https://piqline.com/api/mcpAuthorization: Bearer piq_live_…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"{
"mcpServers": {
"piqline": {
"type": "http",
"url": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer ${PIQLINE_API_KEY}" }
}
}
}出典: code.claude.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。2026-11-20 に実際のキーでテスト済みです。
Codex CLI#
設定場所: ~/.codex/config.toml
Codex はキーを環境変数から読み取ります。PIQLINE_API_KEY をエクスポートしてから、サーバーを設定に追加してください。
[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{
"mcpServers": {
"piqline": {
"httpUrl": "https://piqline.com/api/mcp",
"headers": { "Authorization": "Bearer piq_live_…" }
}
}
}出典: geminicli.com(2026 年 11 月 20 日に確認、公式ドキュメントのブロック)。2026-11-20 に実際のキーでテスト済みです。
Cursor#
設定場所: ~/.cursor/mcp.json または .cursor/mcp.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 に置き換えられると告知されています。
{
"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 の下にサーバーを追加します。
{
"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 にフォールバックします。
{
"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
プロジェクトのファイルにサーバーを追加します。
{
"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 のシークレットに保存されます。
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 リレーを使ってください。
{
"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 に入れます。現在のベータヘッダーは、出典のページを参照してください。
{
"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 に入れます。
{
"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 サーバー。
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 に渡します。
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 のツールになります。
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 ツールセット。
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 に置き、引数にはスペースを入れないでください(スペースで分割するクライアントがあります)。
{
"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 に実際のキーでテスト済みです。