가이드
클라이언트 연결
Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Zed, Mistral Le Chat, Copilot Studio, n8n, LangChain, Vercel SDK 및 모든 MCP 클라이언트에서 Piqline에 연결합니다. 클라이언트별로 복사할 블록을 제공합니다.
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) | 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#
위치: 터미널
명령 하나로 끝납니다. --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를 export한 다음 서버를 설정에 추가하십시오.
[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
명령 하나, 또는 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에 실제 키로 테스트했습니다.