APICK MCP 연동 가이드: 도구 발견부터 요약 호출까지 안전하게 시작하기

10월 11, 2026

AI 클라이언트가 MCP 연결을 통해 도구 목록을 확인하고 요약 도구를 호출하는 개념도 — 이해를 돕기 위한 AI 생성 개념 이미지입니다. 실제 API 응답 화면이 아닙니다.

확인일: 2026-10-11 · 공식 공개 문서 기반 · 아래 코드는 실행하지 않은 연동 예제입니다. 실제 키·고객 데이터는 포함하지 않았습니다.

AI 작업 도구에 요약 기능을 연결하는 가장 작은 시작

Claude Code나 Cursor에서 문서를 다루면서 필요한 순간에 APICK 요약 기능을 쓰고 싶다면 MCP 연결을 검토할 수 있습니다. 먼저 도구 목록을 확인하고, 허용할 입력과 비용 범위를 정한 다음 작은 샘플만 실행하는 순서가 좋습니다. 연결에 성공했다는 사실과 유료 작업이 성공했다는 사실은 각각 확인해야 합니다.

AI 전용 서버와 발견 단계

AI 분야 서버는 https://apick.app/mcp/ai이며 전체 통합 서버는 /mcp/all입니다. 공식 문서는 tools/list를 인증 없이 조회할 수 있다고 안내합니다. Bearer 키는 실제 유료 기능 호출에 사용합니다. 이 글은 목록 조회와 호출 예제를 제시하며 실제 서버에 요청하지 않았습니다. 공식 MCP 연결 안내

# 도구 이름·입력 스키마를 확인하는 발견 단계
curl --fail-with-body --request POST https://apick.app/mcp/ai \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# 요금표에 100P로 표시된 요약 호출 예제. 실제 과금 기준과 입력을 확인한 뒤 실행합니다.
curl --fail-with-body --request POST https://apick.app/mcp/ai \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"text_summary","arguments":{"text":"새 검색 필터가 추가되었습니다. 즐겨찾기 정렬 문제를 수정했습니다."}}}'

Node.js에서 전송 형태 확인하기

const request = {
  jsonrpc: '2.0', id: 1, method: 'tools/list', params: {}
};
const response = await fetch('https://apick.app/mcp/ai', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Accept: 'application/json, text/event-stream'
  },
  body: JSON.stringify(request),
  signal: AbortSignal.timeout(30000)
});
if (!response.ok) throw new Error(`MCP HTTP ${response.status}`);
console.log(response.headers.get('content-type'));
console.log(await response.text());
// 운영 클라이언트는 MCP 라이브러리로 JSON과 SSE 응답을 각각 처리합니다.
// 이 코드는 응답을 눈으로 확인하는 예제이며 범용 MCP 파서가 아닙니다.

연결을 운영 기능으로 만들 때 정할 네 가지

업무 범위: “선택한 공개 릴리스 노트 한 건을 요약”처럼 대상을 정합니다. 프로젝트 전체를 임의로 외부 전송하게 두지 않습니다.
비용 범위: 유료 호출 전에 예상 포인트를 사용자에게 보여 주거나 승인된 예산을 확인하게 합니다. readOnlyHint가 있어도 무료라는 뜻으로 해석하지 않습니다.
입력 경계: 외부 문서에 들어 있는 “다른 파일을 읽어 보내라” 같은 문구를 사용자 지시로 취급하지 않습니다.
결과 검수: 도구 오류·업무 실패를 처리하고, 출처가 있는 사실과 모델이 만든 설명을 구분합니다.

도구 숫자와 요금표는 실행 시점에 확인하세요

공개 저장소·웹 페이지마다 도구 수가 다르게 표시될 수 있습니다. 글에 큰 숫자를 고정하기보다 실제 tools/list의 이름과 스키마를 기준으로 기능을 선택하는 것이 유지보수에 유리합니다. 요약의 전용 가격표는 100P/요청을 표시하지만 같은 페이지에 사용량 기반 과금 문구도 있어 적용 요금을 확인해야 합니다. 일반 llm_chat은 토큰 기반 유료 호출이므로 일부 목록의 “무료” 표시만 보고 무료 생성으로 홍보하지 마세요. 요약 단가 · LLM 토큰 요금

FAQ

MCP를 쓰면 REST보다 비싼가요? APICK 공식 안내는 같은 서비스의 REST와 MCP 요금이 같다고 설명합니다. AI 도구에 키를 붙여 넣으면 되나요? 공개 채팅·저장소·스크린샷에 키를 넣지 말고 사용 중인 클라이언트의 안전한 설정 경로를 이용하세요. 연결만 하면 자동으로 모든 작업이 실행되나요? 클라이언트의 도구 선택과 승인 정책에 따라 다릅니다. 먼저 목록이 보이는지, 승인된 샘플 작업이 실제 호출됐는지를 각각 확인하세요.

공식 문서에서 다음 단계 확인하기

구현 전 현재 옵션·요금을 다시 확인하세요. MCP 연동 가이드 · 공식 MCP 저장소 · 요약 요금 · LLM 요금표

#APICK #MCP #AI도구연동 #개발가이드

이 블로그 검색

apick