# クライアントを接続する

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

Source: https://piqline.com/ja/docs/api/clients

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)](#claude-claude-ai-claude-desktop) | Anthropic | 可 |
| [ChatGPT](#chatgpt) | OpenAI | 不可（オープンな入口のみ） |
| [Mistral Le Chat](#mistral-le-chat) | Mistral AI | 可 |
| [Microsoft Copilot Studio](#microsoft-copilot-studio) | Microsoft | 可 |
| [Claude Code](#claude-code) | Anthropic | 可 |
| [Codex CLI](#codex-cli) | OpenAI | 可 |
| [Gemini CLI](#gemini-cli) | Google | 可 |
| [Cursor](#cursor) | Anysphere | 可 |
| [VS Code (GitHub Copilot)](#vs-code-github-copilot) | Microsoft | 可 |
| [Zed](#zed) | Zed Industries | 可 |
| [Cline](#cline) | Cline | 可 |
| [Roo Code](#roo-code) | Roo Code | 可 |
| [Continue](#continue) | Continue | 可 |
| [Windsurf](#windsurf) | Cognition | リレー経由 |
| [JetBrains AI Assistant](#jetbrains-ai-assistant) | JetBrains | リレー経由 |
| [Goose](#goose) | Block | リレー経由 |
| [Claude API (Messages)](#claude-api-messages) | Anthropic | 可 |
| [OpenAI Responses API](#openai-responses-api) | OpenAI | 可 |
| [OpenAI Agents SDK](#openai-agents-sdk) | OpenAI | 可 |
| [Vercel AI SDK](#vercel-ai-sdk) | Vercel | 可 |
| [LangChain / LangGraph](#langchain-langgraph) | LangChain | 可 |
| [Google ADK](#google-adk) | Google | 可 |
| [n8n](#n8n) | n8n | 可 |
| [CrewAI](#crewai) | CrewAI | リレー経由 |
| [LlamaIndex](#llamaindex) | LlamaIndex | リレー経由 |
| [mcp-remote (any local client)](#mcp-remote-any-local-client) | Open source | 可 |

## アシスタントとアプリ

### Claude (claude.ai, Claude Desktop)

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

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

```text tab="URL"
https://piqline.com/api/mcp
```
```text tab="Header"
Authorization: Bearer piq_live_…
```

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

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

### ChatGPT

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

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

```text
https://piqline.com/api/open/mcp
```

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

### Mistral Le Chat

**設定場所:** コネクタ › MCP コネクタを追加（管理者）

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

```text
https://piqline.com/api/mcp
```

出典: [docs.mistral.ai](https://docs.mistral.ai/le-chat/knowledge-integrations/connectors/mcp-connectors)（2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの）。実際のキーでの検証は、まだ行っていません。

### Microsoft Copilot Studio

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

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

```text
https://piqline.com/api/mcp
```

出典: [learn.microsoft.com](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent)（2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの）。実際のキーでの検証は、まだ行っていません。

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

### Claude Code

**設定場所:** ターミナル

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

```bash tab="CLI"
claude mcp add --transport http piqline https://piqline.com/api/mcp \
  --header "Authorization: Bearer $PIQLINE_API_KEY"
```
```json tab=".mcp.json"
{
  "mcpServers": {
    "piqline": {
      "type": "http",
      "url": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer ${PIQLINE_API_KEY}" }
    }
  }
}
```

出典: [code.claude.com](https://code.claude.com/docs/en/mcp)（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](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)（2026 年 11 月 20 日に確認、公式ドキュメントのブロック）。実際のキーでの検証は、まだ行っていません。

### Gemini CLI

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

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

```bash tab="CLI"
gemini mcp add --transport http \
  --header "Authorization: Bearer $PIQLINE_API_KEY" piqline https://piqline.com/api/mcp
```
```json tab="settings.json"
{
  "mcpServers": {
    "piqline": {
      "httpUrl": "https://piqline.com/api/mcp",
      "headers": { "Authorization": "Bearer piq_live_…" }
    }
  }
}
```

出典: [geminicli.com](https://geminicli.com/docs/tools/mcp-server/)（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](https://cursor.com/docs/context/mcp)（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](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)（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](https://zed.dev/docs/ai/mcp)（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](https://docs.cline.bot/mcp/configuring-mcp-servers)（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](https://roocodeinc.github.io/Roo-Code/features/mcp/using-mcp-in-roo)（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](https://docs.continue.dev/reference)（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](https://docs.devin.ai/desktop/cascade/mcp)（2026 年 11 月 20 日に確認、ヘッダーの記載なし。リレーを推奨）。実際のキーでの検証は、まだ行っていません。

### JetBrains AI Assistant

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

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

[mcp-remote](#mcp-remote-any-local-client) リレーを参照してください。

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

### Goose

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

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

```text
https://piqline.com/api/mcp
```

出典: [goose-docs.ai](https://goose-docs.ai/docs/getting-started/using-extensions)（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](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector)（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](https://developers.openai.com/api/reference/resources/responses/methods/create)（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](https://openai.github.io/openai-agents-python/mcp/)（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](https://ai-sdk.dev/docs/ai-sdk-core/mcp-tools)（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](https://github.com/langchain-ai/langchain-mcp-adapters)（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](https://adk.dev/tools-custom/mcp-tools/)（2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの）。実際のキーでの検証は、まだ行っていません。

### n8n

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

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

```text
https://piqline.com/api/mcp
```

出典: [docs.n8n.io](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/)（2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの）。実際のキーでの検証は、まだ行っていません。

### CrewAI

**設定場所:** Python

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

[mcp-remote](#mcp-remote-any-local-client) リレーを参照してください。

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

### LlamaIndex

**設定場所:** Python

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

[mcp-remote](#mcp-remote-any-local-client) リレーを参照してください。

出典: [developers.llamaindex.ai](https://developers.llamaindex.ai/python/framework/module_guides/mcp/llamaindex_mcp/)（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](https://github.com/geelen/mcp-remote)（2026 年 11 月 20 日に確認、公式ドキュメントをもとに組み立てたもの）。2026-11-20 に実際のキーでテスト済みです。
