사용자 가이드

MCP 빠른 시작

Claude Desktop · Cursor · Gemini CLI 등 MCP를 지원하는 에이전트에 PromStack을 5분 안에 연결합니다.

6분 분량2026-04-30 업데이트

MCP란?

Model Context Protocol은 에이전트(Claude, Cursor, Gemini 등)가 외부 도구를 표준 방식으로 호출하기 위한 프로토콜입니다. PromStack은 MCP 서버를 내장하고 있어, 만들어둔 프롬프트를 에이전트가 자동으로 발견하고 실행할 수 있어요.

1. API 키 발급

설정 → API 키에서 키를 발급하세요. pm_로 시작하는 토큰이 생성됩니다.

보안

키는 한 번만 노출됩니다. 환경 변수로 관리하고 코드에 직접 넣지 마세요.

2. 프롬프트에 Skill 활성화

연결하려는 프롬프트의 상세 페이지에서 우측 액션 바의 MCP 설치 영역을 펼치고, Skill 활성화를 켜세요. 이 프롬프트가 MCP 서버에서 도구로 노출됩니다.

3. Claude Desktop 연결

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는%APPDATA%\Claude\claude_desktop_config.json (Windows)에 다음을 추가합니다.

claude_desktop_config.json

{
  "mcpServers": {
    "promstack": {
      "command": "npx",
      "args": ["-y", "@promstack/mcp"],
      "env": {
        "PROMSTACK_API_KEY": "pm_your_key_here"
      }
    }
  }
}

저장하고 Claude Desktop을 재시작하면 PromStack 도구가 자동으로 연결됩니다.

4. Cursor 연결

Cursor 설정 → MCP 섹션에서 새 서버를 추가하고 동일한 명령을 입력합니다. 자세한 절차는 MCP 서버 레퍼런스를 참고하세요.

5. 동작 확인

연결 후 에이전트에서 “PromStack에서 ‘이메일 답장 초안 작성기’ 프롬프트를 사용해서…” 같은 요청을 해보세요. 에이전트가 자동으로 PromStack 도구를 호출하고 변수를 채워 실행합니다.

MCP 서버 직접 실행 (디버깅)

PROMSTACK_API_KEY=pm_xxx npx -y @promstack/mcp

지원되는 에이전트

Claude Desktop, Claude Code
Cursor
Gemini CLI · Codex · OpenCode · Cline · Windsurf · Continue · Aider · Copilot

각 에이전트별 설치 방식은 프롬프트 상세 페이지의 다운로드 → Skill 패키지로 받아 설치할 수도 있습니다.