본문으로 건너뛰기

가이드

클라이언트 연결

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/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#

위치: 터미널

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

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

명령 하나, 또는 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에 대한 질문이 있거나 이 페이지에 오류가 있나요? 문의하기.