# 클라이언트 연결

> Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Mistral Le Chat, Copilot Studio, n8n, LangChain, Vercel SDK 및 모든 MCP 클라이언트에서 Piqline에 연결합니다. 클라이언트별로 복사할 블록을 제공합니다.

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

Piqline에는 두 개의 MCP 서버가 있으며, 둘 다 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

**위치:** 터미널

명령 하나로 끝납니다. `--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`를 export한 다음 서버를 설정에 추가하십시오.

```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

명령 하나, 또는 `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에 실제 키로 테스트했습니다.
