{
  "$schema": "https://promptarchitect.ai.kr/setup/registry.schema.json",
  "name": "Prompt Architect — Vibe Coder Setup Registry",
  "description": "AI 코딩 에이전트(Claude Code/codex)가 fetch해서 현재 프로젝트에 맞는 스킬·MCP·플러그인·설정을 골라 적용하기 위한 큐레이트 카탈로그. 사람용 페이지: https://promptarchitect.ai.kr/setup",
  "version": "1.0.0",
  "updatedAt": "2026-06-19",
  "agentInstructions": "이 파일을 fetch한 에이전트를 위한 지침: (1) 사용자의 현재 작업 디렉터리/언어/프레임워크/도구를 파악한다. (2) 아래 items에서 tags(lang/framework/task)와 useWhen을 보고 적합한 것만 고른다. (3) 각 item의 install 지시를 따른다 — skill은 raw(.md)를 fetch해 install.target 경로에 저장, mcp는 install.command 실행 또는 install.config를 .mcp.json/settings에 병합, plugin은 install.command 실행. (4) ⚠️ ${...} 플레이스홀더 키는 절대 임의로 채우지 말고 사용자에게 발급/입력을 요청한다. (5) 모든 변경은 사용자 확인 후 적용한다.",
  "items": [
    {
      "id": "peer-rerun",
      "type": "skill",
      "name": "peer-rerun",
      "description": "멈춘(hang) 외부 CLI 피어(codex/agy 등)를 트리째 죽이고 stdin 차단+하드 타임아웃+무성장 감지로 안전 재실행.",
      "useWhen": "외부 CLI를 비대화로 백그라운드 실행했는데 응답이 없거나 출력이 멈춰 무한 대기할 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "agent-orchestration",
          "reliability",
          "cli"
        ]
      },
      "install": {
        "method": "file",
        "target": ".claude/skills/peer-rerun/SKILL.md",
        "raw": "/setup/skills/peer-rerun.md",
        "extra": "동봉 run_peer.sh도 함께 두면 좋음(SKILL.md 참조)."
      }
    },
    {
      "id": "triad",
      "type": "skill",
      "name": "triad",
      "description": "외부 CLI 3인(Claude 리드 + codex + agy)으로 계획/검증을 교차 수행. 모델 다양성으로 합의·불일치 신호 확보.",
      "useWhen": "아키텍처 결정, 멀티파일 리팩토링, 머지 직전 리뷰처럼 놓치면 비용이 큰 비자명한 작업.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "planning",
          "review",
          "agent-orchestration"
        ]
      },
      "install": {
        "method": "file",
        "target": ".claude/skills/triad/SKILL.md",
        "raw": "/setup/skills/triad.md"
      }
    },
    {
      "id": "git-push",
      "type": "skill",
      "name": "git-push",
      "description": "미커밋 변경 → 커밋 → pull → 빌드/테스트 검증 → push 를 원스톱으로. 테스트 실패 시 push 안 함.",
      "useWhen": "안전한 푸시 파이프라인(검증 게이트 포함)을 슬래시 커맨드로 표준화하고 싶을 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "git",
          "ci",
          "workflow"
        ]
      },
      "install": {
        "method": "file",
        "target": ".claude/skills/git-push/SKILL.md",
        "raw": "/setup/skills/git-push.md"
      }
    },
    {
      "id": "session-status",
      "type": "skill",
      "name": "session-status",
      "description": "현재 세션 현황을 7섹션 대시보드(요청/완료/동작변경/남은작업/계획)로 정리해 가시화.",
      "useWhen": "세션이 길어져 '지금까지 뭐 했지/남은 건 뭐지'를 정리하고 싶을 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "productivity",
          "session"
        ]
      },
      "install": {
        "method": "file",
        "target": ".claude/skills/session-status/SKILL.md",
        "raw": "/setup/skills/session-status.md"
      }
    },
    {
      "id": "e2e-test",
      "type": "skill",
      "name": "e2e-test",
      "description": "지정 엔드포인트/모듈에 대한 E2E 테스트를 자동 작성·실행하고 실패 시 자동 수정 시도.",
      "useWhen": "백엔드 라우트나 핵심 플로우의 엔드투엔드 테스트를 빠르게 갖추고 싶을 때.",
      "tags": {
        "lang": [
          "js",
          "ts",
          "python"
        ],
        "framework": [
          "express",
          "fastapi",
          "next"
        ],
        "task": [
          "testing",
          "qa"
        ]
      },
      "install": {
        "method": "file",
        "target": ".claude/skills/e2e-test/SKILL.md",
        "raw": "/setup/skills/e2e-test.md"
      }
    },
    {
      "id": "ui-coherence",
      "type": "skill",
      "name": "ui-coherence",
      "description": "프론트 디자인 정합성(라운드·그림자·강조색·간격·아이콘·타이포·모션·컨트롤높이 8축)을 lint처럼 점검·점수화.",
      "useWhen": "UI를 다수 추가/수정한 직후 '왜 이 화면이 어색하지?' 싶을 때.",
      "tags": {
        "lang": [
          "js",
          "ts"
        ],
        "framework": [
          "react",
          "vue",
          "tailwind"
        ],
        "task": [
          "frontend",
          "design",
          "lint"
        ]
      },
      "install": {
        "method": "file",
        "target": ".claude/skills/ui-coherence/SKILL.md",
        "raw": "/setup/skills/ui-coherence.md"
      }
    },
    {
      "id": "work-verify",
      "type": "skill",
      "name": "work-verify",
      "description": "승인 계획과 git diff를 비교해 구현 완성도(누락·계획과 다름·잠재문제)를 독립 검증.",
      "useWhen": "계획 기반 구현 직후, 테스트 진입 전 '계획대로 다 했나' 점검.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "review",
          "verification"
        ]
      },
      "install": {
        "method": "file",
        "target": ".claude/skills/work-verify/SKILL.md",
        "raw": "/setup/skills/work-verify.md"
      }
    },
    {
      "id": "git-commit",
      "type": "skill",
      "name": "git-commit",
      "description": "변경을 의미 단위로 묶어 깔끔한 커밋 생성. 외부 편집도 감지. 슬래시 커맨드 전용(자동 커밋 금지).",
      "useWhen": "커밋을 표준화하고 키워드 자동 커밋 사고를 막고 싶을 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "git",
          "workflow"
        ]
      },
      "install": {
        "method": "file",
        "target": ".claude/skills/git-commit/SKILL.md",
        "raw": "/setup/skills/git-commit.md"
      }
    },
    {
      "id": "mcp-github",
      "type": "mcp",
      "name": "GitHub MCP",
      "description": "GitHub 저장소·이슈·PR·파일을 에이전트가 다루게 하는 MCP 서버.",
      "useWhen": "에이전트가 GitHub 이슈/PR/리포를 읽고 조작해야 할 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "github",
          "vcs"
        ]
      },
      "install": {
        "method": "mcp",
        "command": "claude mcp add github -- npx -y @modelcontextprotocol/server-github",
        "config": {
          "github": {
            "command": "npx",
            "args": [
              "-y",
              "@modelcontextprotocol/server-github"
            ],
            "env": {
              "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
            }
          }
        },
        "secrets": [
          "GITHUB_PERSONAL_ACCESS_TOKEN"
        ]
      }
    },
    {
      "id": "mcp-context7",
      "type": "mcp",
      "name": "Context7 MCP",
      "description": "라이브러리 공식 문서를 실시간으로 가져와 최신 API 기준으로 코딩하게 돕는 MCP.",
      "useWhen": "최신 라이브러리/프레임워크 문서를 정확히 참조하며 코딩할 때(환각 감소).",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "docs",
          "coding"
        ]
      },
      "install": {
        "method": "mcp",
        "command": "claude mcp add context7 -- npx -y @upstash/context7-mcp",
        "config": {
          "context7": {
            "command": "npx",
            "args": [
              "-y",
              "@upstash/context7-mcp"
            ]
          }
        },
        "secrets": []
      }
    },
    {
      "id": "mcp-playwright",
      "type": "mcp",
      "name": "Playwright MCP",
      "description": "브라우저 자동화(탐색·스크린샷·요소 상호작용)로 웹 테스트·검증을 수행하는 MCP.",
      "useWhen": "에이전트가 실제 브라우저로 UI를 띄워 확인/테스트해야 할 때.",
      "tags": {
        "lang": [
          "js",
          "ts"
        ],
        "framework": [
          "react",
          "vue",
          "any-web"
        ],
        "task": [
          "browser",
          "testing",
          "e2e"
        ]
      },
      "install": {
        "method": "mcp",
        "command": "claude mcp add playwright -- npx -y @playwright/mcp@latest",
        "config": {
          "playwright": {
            "command": "npx",
            "args": [
              "-y",
              "@playwright/mcp@latest"
            ]
          }
        },
        "secrets": []
      }
    },
    {
      "id": "mcp-filesystem",
      "type": "mcp",
      "name": "Filesystem MCP",
      "description": "지정 디렉터리에 한정된 파일 읽기/쓰기 접근을 제공하는 MCP(범위 제한 권장).",
      "useWhen": "특정 폴더에 대한 명시적 파일 접근을 에이전트에 부여하고 싶을 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "files"
        ]
      },
      "install": {
        "method": "mcp",
        "command": "claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ${ALLOWED_DIR}",
        "config": {
          "filesystem": {
            "command": "npx",
            "args": [
              "-y",
              "@modelcontextprotocol/server-filesystem",
              "${ALLOWED_DIR}"
            ]
          }
        },
        "secrets": [
          "ALLOWED_DIR"
        ]
      }
    },
    {
      "id": "mcp-brave-search",
      "type": "mcp",
      "name": "Brave Search MCP",
      "description": "웹 검색을 에이전트에 제공하는 MCP 서버(Brave API).",
      "useWhen": "에이전트가 최신 웹 정보를 검색해야 할 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "search",
          "research"
        ]
      },
      "install": {
        "method": "mcp",
        "command": "claude mcp add brave-search -- npx -y @modelcontextprotocol/server-brave-search",
        "config": {
          "brave-search": {
            "command": "npx",
            "args": [
              "-y",
              "@modelcontextprotocol/server-brave-search"
            ],
            "env": {
              "BRAVE_API_KEY": "${BRAVE_API_KEY}"
            }
          }
        },
        "secrets": [
          "BRAVE_API_KEY"
        ]
      }
    },
    {
      "id": "mcp-memory",
      "type": "mcp",
      "name": "Memory MCP",
      "description": "지식 그래프 메모리 — 세션 간 사실·관계를 저장/검색.",
      "useWhen": "세션을 넘나들며 컨텍스트(결정·엔티티)를 기억시키고 싶을 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "memory",
          "context"
        ]
      },
      "install": {
        "method": "mcp",
        "command": "claude mcp add memory -- npx -y @modelcontextprotocol/server-memory",
        "config": {
          "memory": {
            "command": "npx",
            "args": [
              "-y",
              "@modelcontextprotocol/server-memory"
            ]
          }
        },
        "secrets": []
      }
    },
    {
      "id": "mcp-sequential-thinking",
      "type": "mcp",
      "name": "Sequential Thinking MCP",
      "description": "복잡한 문제를 단계적으로 구조화해 푸는 사고 보조 MCP.",
      "useWhen": "다단계 추론·계획이 필요한 어려운 문제를 다룰 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "reasoning",
          "planning"
        ]
      },
      "install": {
        "method": "mcp",
        "command": "claude mcp add sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking",
        "config": {
          "sequential-thinking": {
            "command": "npx",
            "args": [
              "-y",
              "@modelcontextprotocol/server-sequential-thinking"
            ]
          }
        },
        "secrets": []
      }
    },
    {
      "id": "mcp-fetch",
      "type": "mcp",
      "name": "Fetch MCP",
      "description": "웹 페이지를 가져와 마크다운으로 변환하는 MCP(파이썬, uvx).",
      "useWhen": "에이전트가 웹 문서를 읽어와 참고해야 할 때(브라우저 없이).",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "web",
          "docs",
          "research"
        ]
      },
      "install": {
        "method": "mcp",
        "command": "claude mcp add fetch -- uvx mcp-server-fetch",
        "config": {
          "fetch": {
            "command": "uvx",
            "args": [
              "mcp-server-fetch"
            ]
          }
        },
        "secrets": []
      }
    },
    {
      "id": "plugin-frontend-design",
      "type": "plugin",
      "name": "frontend-design (official)",
      "description": "고품질·비-AI풍 프론트엔드 UI를 생성하도록 돕는 Claude Code 공식 플러그인.",
      "useWhen": "차별화된 프로덕션급 프론트엔드 컴포넌트/페이지를 만들 때.",
      "tags": {
        "lang": [
          "js",
          "ts"
        ],
        "framework": [
          "react",
          "vue",
          "svelte"
        ],
        "task": [
          "frontend",
          "design"
        ]
      },
      "install": {
        "method": "plugin",
        "command": "/plugin install frontend-design@claude-plugins-official"
      }
    },
    {
      "id": "setting-statusline",
      "type": "setting",
      "name": "statusLine 스니펫",
      "description": "Claude Code 하단 상태줄에 모델·브랜치·토큰 등을 표시하는 settings.json 스니펫.",
      "useWhen": "세션 상태를 항상 보이게 하고 싶을 때.",
      "tags": {
        "lang": [
          "any"
        ],
        "framework": [
          "any"
        ],
        "task": [
          "dx",
          "settings"
        ]
      },
      "install": {
        "method": "merge-settings",
        "target": ".claude/settings.json",
        "config": {
          "statusLine": {
            "type": "command",
            "command": "~/.claude/statusline.sh"
          }
        }
      }
    },
    {
      "id": "mcp-time",
      "type": "mcp",
      "name": "time",
      "description": "현재 시각 조회와 타임존 간 시간 변환을 제공하는 공식 reference MCP 서버. get_current_time(타임존별 현재시각)과 convert_time(타임존 간 변환) 두 도구를 제공한다.",
      "useWhen": "AI가 특정 타임존의 현재 시각을 알아야 하거나, 한국시간↔다른 지역 시간 변환 같은 시간대 계산이 필요할 때.",
      "tags": {
        "framework": [],
        "lang": [
          "python"
        ],
        "task": [
          "time",
          "timezone",
          "utility"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add time -- uvx mcp-server-time",
        "env": []
      },
      "source_url": "https://github.com/modelcontextprotocol/servers/tree/main/src/time",
      "popularity": "Anthropic 공식 modelcontextprotocol/servers 레포의 reference 서버. 널리 쓰임.",
      "seo": {
        "seoTitle": "time MCP 서버 — Claude Code 현재 시각·타임존 변환 도구",
        "metaDescription": "현재 시각 조회와 타임존 간 시간 변환을 제공하는 공식 reference MCP 서버. get_current_time과 convert_time 두 도구로 Claude Code에 정확한 시간 인식을 더한다.",
        "summary": "time은 Model Context Protocol(MCP) 공식 reference 서버 중 하나로, AI 어시스턴트에 \"현재 시각\"과 \"타임존 변환\" 능력을 더하는 경량 유틸리티 서버다. LLM은 기본적으로 실제 현재 시각을 알지 못하고 학습 시점에 멈춰 있기 때문에, \"지금 몇 시야?\", \"서울 기준 오후 3시는 뉴욕에선 몇 시야?\" 같은 질문에 부정확하게 답하거나 추측하는 문제가 있다. time 서버는 이 공백을 메워, Claude Code가 호스트 시스템과 표준 타임존 데이터베이스를 근거로 정확한 시간을 다루게 해준다.\n\n제공하는 도구는 두 가지다. get_current_time은 지정한 IANA 타임존(예: Asia/Seoul, America/New_York)의 현재 시각을 반환한다. convert_time은 한 타임존의 특정 시각을 다른 타임존 기준 시각으로 변환해, 일광절약시간(DST)까지 반영한 결과를 돌려준다. 두 도구 모두 외부 네트워크 호출 없이 시스템 시계와 타임존 규칙만으로 동작하는 단순·결정적 기능이다.\n\n이 서버가 유용한 사람은, 회의·마감·릴리스 일정을 여러 지역 기준으로 따져야 하는 글로벌 협업 환경의 개발자, \"오늘 날짜\"나 \"현재 시각\"을 코드/문서/커밋 로그에 넣어야 하는 작업, 또는 시간대가 얽힌 스케줄링 로직을 다루는 사람이다. Python 기반이며 uvx로 간편하게 실행되어 설치 부담이 작다. 기능 범위가 좁고 명확해, 처음 MCP를 도입할 때 동작을 검증해 보는 입문용으로도 적합하다. 정확한 설치/실행 방식은 별도 표시된 명령과 공식 GitHub 문서를 확인하길 권장한다.",
        "whenToUse": "LLM이 모르는 \"실제 현재 시각\"이 필요할 때, 여러 지역의 회의·마감·배포 일정을 타임존 변환해 맞춰야 할 때, 커밋/문서/로그에 정확한 날짜·시간을 넣어야 할 때 쓰면 좋다. 일광절약시간까지 반영한 시각 변환이 필요한 글로벌 협업에 특히 유용하며, 기능이 단순·결정적이라 MCP 도입 검증용 입문 서버로도 적합하다.",
        "installNotes": "Python 기반이며 uvx(uv 패키지 러너)로 실행되므로, 시스템에 uv가 설치돼 있어야 한다(없으면 먼저 uv 설치 필요). 동작은 호스트 시스템 시계와 IANA 타임존 데이터에 의존하므로, 서버 시간이 틀어져 있으면 결과도 틀어진다 — 호스트 시각이 정확한지 먼저 확인하자. 타임존은 Asia/Seoul처럼 IANA 식별자를 사용한다. 기본 타임존 등 옵션은 공식 GitHub 문서 확인을 권장한다.",
        "securityNotes": "API 키·토큰 등 비밀키가 필요 없고(env 없음), 외부 네트워크나 결제·삭제 같은 부수효과가 없는 읽기성 유틸리티라 위험도가 낮다. 다만 호스트의 로컬 시각·타임존 설정에 접근하므로, 시스템 시계가 부정확하거나 조작되면 잘못된 시간이 그대로 응답에 반영될 수 있다. 또한 변환 결과 텍스트를 후속 자동화(일정 생성·삭제 등)에 그대로 넘길 경우, 외부 입력이 섞인 프롬프트 인젝션으로 의도치 않은 동작이 유도될 수 있으니 결과는 사람이 한 번 확인하는 게 안전하다.",
        "faq": [
          {
            "q": "time MCP 서버는 어떤 도구를 제공하나요?",
            "a": "두 가지입니다. get_current_time은 지정한 타임존의 현재 시각을 반환하고, convert_time은 한 타임존의 특정 시각을 다른 타임존 기준으로 변환합니다. 둘 다 일광절약시간(DST) 규칙을 반영합니다."
          },
          {
            "q": "API 키나 별도 계정이 필요한가요?",
            "a": "아니요. 비밀키나 외부 계정이 필요 없습니다. 호스트 시스템 시계와 IANA 타임존 데이터만으로 동작하는 읽기성 유틸리티 서버라 외부 네트워크 호출도 없습니다."
          },
          {
            "q": "왜 LLM에 별도 시간 서버가 필요한가요?",
            "a": "LLM은 학습 시점에 멈춰 있어 실제 현재 시각을 알지 못합니다. time 서버를 붙이면 Claude Code가 시스템 시계를 근거로 정확한 현재 시각과 타임존 변환 결과를 제공할 수 있습니다."
          }
        ],
        "relatedIds": [
          "mcp-git",
          "mcp-everything"
        ]
      }
    },
    {
      "id": "mcp-git",
      "type": "mcp",
      "name": "git",
      "description": "로컬 Git 저장소를 읽고 검색하고 조작하는 공식 reference MCP 서버. status·diff·log·commit·branch 등 Git 작업을 도구로 노출한다. (--repository로 대상 저장소 경로 지정)",
      "useWhen": "AI가 로컬 Git 저장소의 상태/변경/커밋 히스토리를 구조화된 도구로 직접 다뤄야 할 때(쉘 git 호출 대신).",
      "tags": {
        "framework": [],
        "lang": [
          "python"
        ],
        "task": [
          "git",
          "version-control",
          "developer-tools"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add git -- uvx mcp-server-git --repository /path/to/repo",
        "env": []
      },
      "source_url": "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
      "popularity": "Anthropic 공식 modelcontextprotocol/servers 레포의 reference 서버.",
      "seo": {
        "seoTitle": "git MCP 서버 — Claude Code로 로컬 Git 저장소 읽기·diff·커밋 자동화",
        "metaDescription": "Claude Code용 공식 git MCP 서버. 로컬 Git 저장소의 status·diff·log·commit·branch를 도구로 노출해 AI가 직접 버전 관리 작업을 수행하도록 돕는 reference 서버입니다.",
        "summary": "git MCP 서버는 Model Context Protocol(MCP) 공식 reference 구현 중 하나로, 로컬 Git 저장소를 AI가 직접 읽고 검색하고 조작할 수 있게 해 주는 서버입니다. Claude Code 같은 MCP 클라이언트에 연결하면, AI가 사람의 손을 거치지 않고 저장소 상태를 파악하고 변경 이력을 추적하며 커밋·브랜치 작업까지 도구(tool) 호출로 수행할 수 있습니다.\n\n핵심은 Git의 일상 작업을 MCP 도구로 노출한다는 점입니다. 대표적으로 워킹 트리 상태 확인(status), 변경 내용 비교(diff), 커밋 이력 조회(log), 변경 사항 커밋(commit), 브랜치 생성·조회 같은 명령을 AI가 호출할 수 있습니다. 덕분에 \"지금 무엇이 바뀌었는지 보여 줘\", \"이 변경을 커밋해 줘\", \"최근 커밋 이력을 요약해 줘\" 같은 자연어 요청을 AI가 실제 Git 동작으로 옮길 수 있습니다. 대상 저장소는 설치 시 --repository로 경로를 지정합니다.\n\n이런 작업이 가능해지면 AI 코딩 워크플로의 마찰이 크게 줄어듭니다. 코드 변경을 만든 뒤 별도 터미널로 전환하지 않고도 diff를 검토하고, 커밋 메시지를 작성해 커밋하고, 작업용 브랜치를 만드는 흐름을 한 대화 안에서 이어갈 수 있습니다. 또 변경 이력·diff를 컨텍스트로 활용해 코드 리뷰, 변경점 요약, 회귀 원인 추적 같은 분석에도 유용합니다.\n\nPython(uvx) 기반으로 동작하는 공식 서버라 도입 장벽이 낮고, MCP 생태계의 표준 동작을 익히는 학습용으로도 적합합니다. AI 에이전트에게 버전 관리 작업을 위임하려는 개발자, Claude Code로 커밋 흐름까지 자동화하려는 사람, MCP를 처음 시험해 보려는 사용자에게 권장됩니다. 사용 가능한 정확한 도구 목록과 인자는 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다.",
        "whenToUse": "Claude Code에서 코드 변경 후 별도 터미널 없이 diff 검토·커밋·브랜치 작업까지 한 흐름으로 처리하고 싶을 때 적합합니다. AI에게 커밋 메시지 작성과 커밋 실행을 맡기거나, 변경 이력·diff를 컨텍스트로 한 코드 리뷰·변경점 요약·회귀 추적을 자동화할 때 유용합니다. MCP를 처음 익히는 학습용으로도 좋습니다. 단, 원격 호스팅(GitHub·GitLab) API 연동이 목적이라면 전용 서버가 더 맞습니다.",
        "installNotes": "Python 실행기 uvx(uv 패키지에 포함)가 필요하므로 uv를 먼저 설치하세요. 설치 명령의 --repository에는 대상 Git 저장소의 실제 절대 경로를 넣어야 하며, 지정한 경로가 유효한 Git 저장소여야 도구가 정상 동작합니다. 여러 저장소를 다루려면 별칭을 달리해 여러 인스턴스로 등록하는 방식을 고려하세요. 설치 후 Claude Code에서 도구 노출 여부를 확인하고, 제공 도구 목록·인자는 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다.",
        "securityNotes": "이 서버는 별도 API 키나 비밀키를 요구하지 않지만, 지정한 로컬 저장소에 대한 파일 읽기 및 Git 쓰기 권한을 AI에 부여합니다. commit·branch 등 상태를 변경하는 도구가 노출되므로, AI가 의도치 않게 커밋을 만들거나 브랜치를 바꿀 수 있습니다. 따라서 신뢰하는 저장소 경로만 --repository로 지정하고, 비밀키·인증서·.env 등 민감 파일이 포함된 디렉터리는 주의하세요. diff·log·파일 내용에 포함된 외부 텍스트가 프롬프트 인젝션 경로가 될 수 있으니, AI가 제안한 커밋·변경은 적용 전 사람이 검토하길 권장합니다.",
        "faq": [
          {
            "q": "git MCP 서버로 어떤 Git 작업을 할 수 있나요?",
            "a": "워킹 트리 상태 확인(status), 변경 비교(diff), 커밋 이력 조회(log), 커밋(commit), 브랜치 생성·조회 같은 일상 Git 작업을 도구로 노출합니다. 정확한 도구 목록과 인자는 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다."
          },
          {
            "q": "어떤 저장소를 대상으로 동작하나요?",
            "a": "설치 시 --repository로 지정한 로컬 Git 저장소의 절대 경로를 대상으로 동작합니다. 여러 저장소를 다루려면 별칭을 달리해 여러 인스턴스로 등록하는 방식을 고려하세요."
          },
          {
            "q": "GitHub나 GitLab 같은 원격 서비스도 연동되나요?",
            "a": "이 서버는 로컬 Git 저장소 조작에 초점을 둔 reference 서버입니다. 원격 호스팅 서비스의 PR·이슈 등 API 연동이 필요하면 GitLab Duo 같은 전용 MCP 서버를 함께 고려하는 것이 적합합니다."
          }
        ],
        "relatedIds": [
          "mcp-gitlab",
          "mcp-everything",
          "mcp-time"
        ]
      }
    },
    {
      "id": "mcp-everything",
      "type": "mcp",
      "name": "everything",
      "description": "MCP 프로토콜의 거의 모든 기능(tools·resources·prompts·sampling 등)을 시연하는 공식 reference/테스트 서버. 실사용 목적이 아니라 MCP 클라이언트 개발자가 프로토콜 동작을 검증하기 위한 데모 서버다.",
      "useWhen": "MCP 클라이언트/연동을 개발·디버깅하면서 프로토콜의 각 기능(도구·리소스·프롬프트·샘플링)이 제대로 동작하는지 테스트할 때. 일반 운영 용도가 아님.",
      "tags": {
        "framework": [],
        "lang": [
          "typescript"
        ],
        "task": [
          "testing",
          "reference",
          "mcp-development"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add everything -- npx -y @modelcontextprotocol/server-everything",
        "env": []
      },
      "source_url": "https://github.com/modelcontextprotocol/servers/tree/main/src/everything",
      "popularity": "Anthropic 공식 reference 서버(프로토콜 전체 기능 시연용 테스트 서버).",
      "seo": {
        "seoTitle": "everything MCP 서버 — MCP 프로토콜 전 기능 데모·테스트용 공식 reference 서버",
        "metaDescription": "everything는 MCP의 tools·resources·prompts·sampling 등 거의 모든 기능을 시연하는 공식 reference/테스트 서버. MCP 클라이언트 개발자가 프로토콜 동작을 검증할 때 쓴다.",
        "summary": "everything는 Model Context Protocol(MCP)의 거의 모든 기능을 한 서버에 모아 시연하는 공식 reference(참조)/테스트 서버입니다. 특정 외부 서비스(DB·검색·SaaS)에 연결해 실제 업무를 처리하기 위한 서버가 아니라, MCP 프로토콜 자체가 정의한 기능들이 클라이언트에서 어떻게 동작하는지 보여주는 데모 목적의 서버입니다. 이름 그대로 \"everything\", 즉 프로토콜의 주요 기능을 한곳에서 둘러볼 수 있도록 설계되어 있습니다.\n\n무엇을 푸는가: MCP 클라이언트(예: Claude Code, IDE 확장, 자체 제작 호스트)를 개발하거나 통합할 때, 내 클라이언트가 tools 호출, resources 읽기, prompts 사용, sampling 요청 등 프로토콜 요소를 규격대로 처리하는지 검증할 안정적인 테스트 대상이 필요합니다. everything는 이런 기능들을 예시로 노출해, 실제 외부 의존성 없이도 클라이언트의 프로토콜 처리·UI 렌더링·에러 핸들링을 점검하게 해 줍니다.\n\n핵심 성격: ① tools·resources·prompts·sampling 등 MCP의 주요 기능 영역을 폭넓게 시연하는 데모/레퍼런스 서버, ② TypeScript로 작성된 공식 modelcontextprotocol/servers 저장소 산하 패키지, ③ 실사용보다 \"동작 확인·학습·회귀 테스트\"가 주 용도. 구체적으로 어떤 도구·리소스 이름과 동작이 노출되는지, 버전별 지원 범위는 공식 문서(저장소 README)를 확인하는 것을 권장합니다.\n\n누가 쓰면 좋은가: MCP 클라이언트/호스트를 만드는 개발자, MCP를 처음 배우며 프로토콜 기능을 손으로 만져 보려는 사람, MCP 연동 코드의 회귀 테스트 픽스처가 필요한 팀에 적합합니다. 반대로 실제 데이터 조회나 업무 자동화가 목적이라면 git·time·DB·검색 계열 등 용도에 맞는 MCP 서버를 쓰는 편이 맞습니다.",
        "whenToUse": "MCP 클라이언트·호스트를 개발·통합하면서 프로토콜 동작(tools·resources·prompts·sampling)을 외부 의존성 없이 검증하고 싶을 때, MCP를 처음 배우며 각 기능이 클라이언트에서 어떻게 보이는지 직접 만져 보고 싶을 때, 연동 코드의 회귀 테스트용 안정적 대상이 필요할 때 적합합니다. 실제 데이터 조회·업무 자동화가 목적이라면 용도에 맞는 다른 MCP 서버를 쓰는 편이 낫습니다.",
        "installNotes": "npx로 실행되므로 Node.js와 npx가 설치돼 있어야 하며, 첫 실행 시 npm 레지스트리에서 패키지를 내려받습니다(네트워크 필요). 데모/테스트 전용 서버라 운영 환경 상시 연결 대상으로는 부적합하니 검증이 끝나면 클라이언트 설정에서 제거하는 것을 권장합니다. 노출되는 도구·리소스의 구체 목록과 버전별 지원 범위는 공식 저장소 README로 확인하세요. 명령에 별도 환경변수는 필요하지 않습니다.",
        "securityNotes": "필수 비밀키·토큰이 없고(env 없음), 외부 서비스 자격증명도 요구하지 않습니다. 다만 sampling 기능을 시연하므로, 연결한 클라이언트의 LLM 호출 흐름이 트리거될 수 있다는 점은 인지하세요. everything가 노출하는 prompts·resources 등 콘텐츠가 모델 입력에 들어갈 경우 프롬프트 인젝션 가능성을 일반론으로 염두에 둬야 하나, 공식 데모 서버 범위에서 위험은 제한적입니다. npx 실행은 npm에서 코드를 받아 로컬에서 구동하므로 신뢰된 공식 패키지(modelcontextprotocol)인지 출처를 확인하고, 테스트가 끝나면 연결을 해제하세요.",
        "faq": [
          {
            "q": "everything MCP 서버는 실제 업무에 써도 되나요?",
            "a": "권장되지 않습니다. 이 서버는 MCP 프로토콜 기능을 시연하는 공식 reference/테스트용 데모 서버로, 실제 데이터 조회나 업무 자동화가 아니라 클라이언트가 tools·resources·prompts·sampling을 규격대로 처리하는지 검증하는 데 쓰입니다. 실사용 목적이면 용도에 맞는 다른 MCP 서버를 쓰세요."
          },
          {
            "q": "어떤 기능을 시연하나요?",
            "a": "MCP의 주요 기능 영역인 tools·resources·prompts·sampling 등을 폭넓게 보여줍니다. 구체적으로 노출되는 도구·리소스 이름과 동작, 버전별 지원 범위는 공식 modelcontextprotocol/servers 저장소의 README에서 확인하는 것을 권장합니다."
          },
          {
            "q": "API 키나 비밀키가 필요한가요?",
            "a": "아니요. 별도 환경변수나 외부 서비스 자격증명 없이 동작합니다. 다만 sampling 시연이 연결된 클라이언트의 LLM 호출 흐름을 트리거할 수 있다는 점은 인지해 두세요."
          }
        ],
        "relatedIds": [
          "mcp-time",
          "mcp-git",
          "mcp-builder"
        ]
      }
    },
    {
      "id": "mcp-supabase",
      "type": "mcp",
      "name": "Supabase MCP Server",
      "description": "Supabase 프로젝트(PostgreSQL DB, 테이블, 마이그레이션, 로그)를 자연어로 조회·관리하는 공식 MCP 서버. SQL 실행과 스키마 탐색을 지원한다.",
      "useWhen": "Supabase를 백엔드/DB로 쓰는 프로젝트에서 테이블 조회, SQL 실행, 마이그레이션, 프로젝트 관리를 AI로 하고 싶을 때.",
      "tags": {
        "framework": [
          "supabase"
        ],
        "lang": [
          "sql"
        ],
        "task": [
          "database",
          "backend",
          "migration",
          "query"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add supabase -- npx -y @supabase/mcp-server-supabase@latest --access-token $SUPABASE_ACCESS_TOKEN",
        "env": [
          "SUPABASE_ACCESS_TOKEN"
        ],
        "secrets": [
          "SUPABASE_ACCESS_TOKEN"
        ]
      },
      "source_url": "https://github.com/supabase-community/supabase-mcp",
      "popularity": "supabase-community 공식 repo, GitHub 약 2.7K stars. 널리 쓰임.",
      "seo": {
        "seoTitle": "Supabase MCP Server: Claude Code에서 DB·SQL·마이그레이션 관리",
        "metaDescription": "Supabase 공식 MCP 서버로 Claude Code에서 PostgreSQL DB, 테이블, SQL 실행, 마이그레이션, 로그를 자연어로 조회·관리하세요. read-only·프로젝트 스코프 설정과 보안 주의점 정리.",
        "summary": "Supabase MCP Server는 Claude Code 같은 AI 어시스턴트를 Supabase 프로젝트에 연결해, PostgreSQL 데이터베이스와 프로젝트 설정을 자연어로 조회·관리하게 해주는 Supabase 측 공식(커뮤니티 관리) MCP 서버입니다. AI가 SQL을 직접 실행하고 스키마를 탐색할 수 있어, \"테이블 목록 보여줘\", \"이 쿼리 돌려줘\", \"스키마에서 TypeScript 타입 생성해줘\" 같은 요청을 별도 콘솔 전환 없이 대화 안에서 처리할 수 있습니다.\n\n핵심 기능은 크게 나뉩니다. 데이터베이스 영역에서는 테이블·확장(extension) 조회, SQL 쿼리 및 마이그레이션 실행, 스키마 기반 TypeScript 타입 생성을 지원합니다. 프로젝트 관리 영역에서는 프로젝트 목록·생성·일시정지, 조직·비용 조회, 프로젝트 URL/API 키 접근이 가능합니다. 개발 지원으로는 Edge Functions 배포·관리, 로그·어드바이저(advisor) 점검을 통한 디버깅을 돕고, 유료 플랜에서는 개발 브랜치 생성·머지(branching), 선택적으로 스토리지 버킷 관리도 제공합니다. Supabase 공식 문서 검색 도구도 포함돼 작업 중 레퍼런스 확인이 쉽습니다.\n\n동작 범위는 설정으로 제어합니다. read-only 모드는 읽기 전용 Postgres 사용자로 SQL을 실행해 변경성(mutating) 도구를 비활성화하고, 프로젝트 스코프(project_ref)는 특정 프로젝트로 접근을 한정합니다. 기능 그룹(feature groups)으로 database/functions/storage/branching 등 도구 카테고리를 켜고 끌 수 있어 최소 권한 구성을 만들기 좋습니다.\n\nSupabase로 백엔드를 운영하며 스키마 작업, 데이터 점검, 마이그레이션, 로그 디버깅을 AI와 함께 빠르게 반복하려는 개발자에게 적합합니다. 다만 프로덕션 데이터에 직접 붙이는 용도로는 권장되지 않으므로, 정확한 옵션과 최신 도구 목록은 공식 문서 확인을 권장합니다.",
        "whenToUse": "Supabase를 백엔드로 쓰면서 Claude Code 안에서 테이블·스키마를 탐색하거나, 임시 SQL 조회·집계, 마이그레이션 작성·적용, 로그/어드바이저 기반 디버깅, 스키마→TypeScript 타입 생성을 반복할 때 유용합니다. 콘솔과 에디터를 오가지 않고 대화로 DB 작업을 진행하고 싶을 때, 특히 개발/스테이징 프로젝트에서 효율이 큽니다. 운영 데이터 직접 조작에는 권장되지 않습니다.",
        "installNotes": "설치 전 Supabase에서 개인 액세스 토큰(SUPABASE_ACCESS_TOKEN)을 발급해 환경변수로 준비해야 합니다. Node.js와 npx 실행 환경이 필요합니다(서버를 npx로 받아 구동). 모든 프로젝트에 광범위하게 붙이기보다 read-only 모드와 프로젝트 스코프(project_ref), 기능 그룹 제한을 함께 적용해 최소 권한으로 구성하는 것을 권장합니다. 정확한 플래그와 최신 옵션은 공식 문서 확인을 권장합니다.",
        "securityNotes": "SUPABASE_ACCESS_TOKEN은 토큰 소유자 권한으로 프로젝트·DB·API 키·비용 정보에 접근하므로 사실상 광범위한 자격증명입니다. 출력·커밋·로그 노출을 금하고 환경변수/시크릿으로만 관리하세요. read-only 모드와 프로젝트 스코프로 권한 범위를 좁히는 것이 안전합니다. 변경성 도구는 데이터 삭제·스키마 변경·프로젝트 생성 등 파괴적·과금성 작업이 가능하니 실행 전 도구 호출을 직접 검토하세요. DB에 저장된 신뢰할 수 없는 데이터가 프롬프트 인젝션으로 LLM을 유도할 수 있어, 공식 권고대로 프로덕션 데이터가 아닌 개발 프로젝트 사용을 권장합니다.",
        "faq": [
          {
            "q": "read-only 모드는 무엇을 막아주나요?",
            "a": "읽기 전용 Postgres 사용자로 SQL을 실행해 INSERT/UPDATE/DELETE나 마이그레이션 같은 변경성 도구를 비활성화합니다. 데이터 조회·디버깅 위주 작업에서 실수로 인한 변경을 차단하는 기본 안전장치로 권장됩니다."
          },
          {
            "q": "프로덕션 DB에 바로 연결해도 되나요?",
            "a": "공식적으로는 권장되지 않습니다. 토큰 권한이 넓고 프롬프트 인젝션 위험이 있어, 프로덕션이 아닌 개발/스테이징 프로젝트에 연결하고 read-only·프로젝트 스코프·기능 그룹으로 범위를 좁히는 것이 안전합니다."
          },
          {
            "q": "특정 프로젝트로만 접근을 제한할 수 있나요?",
            "a": "네. 프로젝트 스코프(project_ref)로 한 프로젝트에만 접근하도록 한정할 수 있고, 기능 그룹으로 database/functions/storage/branching 등 도구 카테고리를 선택적으로 켜고 끌 수 있습니다. 자세한 설정은 공식 문서 확인을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-postgres-pro",
          "mcp-neon",
          "mcp-dbhub"
        ]
      }
    },
    {
      "id": "mcp-postgres-pro",
      "type": "mcp",
      "name": "Postgres MCP Pro (crystaldba)",
      "description": "PostgreSQL용 MCP 서버. 설정 가능한 읽기/쓰기 접근, 인덱스 튜닝·실행계획(EXPLAIN) 분석 등 성능 진단 기능을 제공한다.",
      "useWhen": "자체 호스팅 PostgreSQL을 AI로 조회/관리하고, 느린 쿼리 성능 분석·인덱스 추천까지 필요할 때.",
      "tags": {
        "framework": [
          "postgresql"
        ],
        "lang": [
          "sql",
          "python"
        ],
        "task": [
          "database",
          "backend",
          "performance",
          "query"
        ]
      },
      "install": {
        "method": "command",
        "command": "docker pull crystaldba/postgres-mcp  (또는 pipx install postgres-mcp). 연결은 DATABASE_URI 환경변수로 지정. 정확한 클라이언트 설정은 공식 문서 참조.",
        "env": [
          "DATABASE_URI"
        ],
        "secrets": [
          "DATABASE_URI"
        ]
      },
      "source_url": "https://github.com/crystaldba/postgres-mcp",
      "popularity": "PostgreSQL MCP 중 성능 분석 기능으로 널리 알려짐(awesome-mcp 다수 등재). stars 추정 수천.",
      "seo": {
        "seoTitle": "Postgres MCP Pro: PostgreSQL 인덱스 튜닝·실행계획 분석 MCP 서버",
        "metaDescription": "crystaldba의 오픈소스 Postgres MCP Pro 서버. PostgreSQL 인덱스 튜닝, EXPLAIN 실행계획 분석, DB 헬스 진단, 설정 가능한 읽기/쓰기 안전 SQL 실행을 AI 에이전트에 연결한다.",
        "summary": "Postgres MCP Pro는 crystaldba가 만든 오픈소스(MIT) Model Context Protocol(MCP) 서버로, Claude Code 같은 AI 에이전트를 PostgreSQL 데이터베이스에 연결해 단순 조회를 넘어 성능 진단과 튜닝까지 맡길 수 있게 한다. 단순히 DB 연결을 감싸는 수준이 아니라, 초기 코딩부터 테스트·배포·운영 튜닝·유지보수까지 개발 전 과정을 지원하는 것을 목표로 설계됐다.\n\n핵심 기능은 네 갈래다. 첫째 데이터베이스 헬스 진단 — 인덱스 상태, 커넥션 사용률, 버퍼 캐시, vacuum 상태, 시퀀스 한계, 복제 지연 등을 분석한다. 둘째 인덱스 튜닝 — 워크로드에 맞춰 수많은 인덱스 후보를 탐색해 최적안을 제안한다(가상 인덱스 효과 시뮬레이션 포함). 셋째 쿼리 플랜 검토 — EXPLAIN 실행계획을 읽어 병목을 찾고 최적화 방향을 제시한다. 넷째 스키마 인지형 SQL 생성과 안전 실행 — 스키마를 이해한 컨텍스트 기반 SQL 생성과 함께, 읽기 전용 모드·안전 SQL 파싱 등 설정 가능한 접근 제어를 제공해 개발·운영 환경 모두에서 쓸 수 있다.\n\n따라서 \"ORM이 만든 쿼리가 느린데 왜 그런지 모르겠다\", \"어떤 인덱스를 추가해야 효과가 클지 모르겠다\", \"운영 DB 상태를 주기적으로 점검하고 싶다\" 같은 문제에 잘 맞는다. 대상은 PostgreSQL을 쓰는 백엔드 개발자, 데이터/플랫폼 엔지니어, AI 에이전트로 DB 작업을 자동화하려는 팀이다. stdio와 SSE 두 가지 트랜스포트를 지원해 로컬 클라이언트와 원격 환경 모두에 연결할 수 있고, 설치는 Docker 이미지 또는 Python(pipx/uv) 두 방식 중 선택한다. 연결은 DATABASE_URI 환경변수로 지정하며, 정확한 클라이언트 설정 값은 환경마다 다르므로 공식 문서 확인을 권장한다.",
        "whenToUse": "PostgreSQL 쿼리·인덱스 성능을 AI 에이전트와 함께 진단·개선하고 싶을 때 적합하다. 느린 ORM/SQL 쿼리의 EXPLAIN 분석, 워크로드 기반 인덱스 후보 탐색, 인덱스·vacuum·커넥션·복제 등 DB 헬스 점검이 핵심 용도다. 개발 중 스키마 인지형 SQL 생성이 필요하거나, 운영 DB에서 읽기 전용 등 접근 제어를 둔 채 안전하게 점검하려는 경우에도 좋다.",
        "installNotes": "Docker 이미지(crystaldba/postgres-mcp) 또는 Python(pipx/uv) 중 하나로 설치하며, 실행에는 Docker 또는 Python 3.12 이상이 필요하다. DB 연결은 DATABASE_URI 환경변수로 전달하고, 사전에 psql이나 pgAdmin으로 접속 정보가 유효한지 확인하면 좋다. stdio·SSE 트랜스포트를 지원하므로 사용하는 MCP 클라이언트(Claude Desktop/Code 등)에 맞춰 설정 파일을 편집해야 한다. 클라이언트별 정확한 등록 형식과 읽기/쓰기 모드 옵션은 환경마다 달라 공식 문서 확인을 권장한다.",
        "securityNotes": "DATABASE_URI에는 DB 호스트·사용자·비밀번호가 포함되므로 시크릿으로 취급해 환경변수/시크릿 매니저로만 주입하고 로그·커밋·코드에 노출하지 말아야 한다. 쓰기 모드로 연결하면 에이전트가 INSERT/UPDATE/DELETE·DDL 등 데이터 변경·삭제를 수행할 수 있으니, 운영 DB에는 읽기 전용 모드와 최소 권한 계정 사용을 권장한다. 스키마·데이터 내용이나 EXPLAIN 결과가 LLM에 전달되므로 민감 데이터 노출 범위를 확인하고, 테이블 코멘트·데이터 등 외부 입력에 섞인 프롬프트 인젝션 가능성도 염두에 두고 결과를 검증한다.",
        "faq": [
          {
            "q": "GPT-4.1 같은 LLM API 비용이 추가로 드나요?",
            "a": "Postgres MCP Pro 자체는 오픈소스 MCP 서버라 별도 LLM 과금이 없습니다. 다만 연결한 AI 에이전트(Claude 등)가 스키마·EXPLAIN 결과를 처리하면서 토큰을 소비하므로, 비용은 사용하는 클라이언트의 모델 요금에 따릅니다."
          },
          {
            "q": "운영 DB에 붙여도 안전한가요?",
            "a": "설정 가능한 접근 제어(읽기 전용 모드, 안전 SQL 파싱)를 제공해 개발·운영 양쪽을 염두에 두고 설계됐습니다. 운영 환경에서는 읽기 전용 모드와 최소 권한 계정을 함께 쓰는 것을 권장하며, 정확한 옵션은 공식 문서 확인을 권합니다."
          },
          {
            "q": "Supabase나 Neon 같은 매니지드 PostgreSQL에도 쓸 수 있나요?",
            "a": "DATABASE_URI로 접속 가능한 PostgreSQL이면 일반적으로 연결할 수 있습니다. 다만 매니지드 서비스는 일부 확장/권한 제약이 있을 수 있어 인덱스 시뮬레이션 등 기능 호환은 환경에 따라 확인이 필요합니다."
          }
        ],
        "relatedIds": [
          "mcp-neon",
          "mcp-supabase",
          "mcp-dbhub"
        ]
      }
    },
    {
      "id": "mcp-mongodb",
      "type": "mcp",
      "name": "MongoDB MCP Server",
      "description": "MongoDB 데이터베이스 및 Atlas 클러스터에 연결하는 공식(mongodb-js) MCP 서버. 컬렉션 탐색, 쿼리, read-only 모드를 지원한다.",
      "useWhen": "MongoDB나 MongoDB Atlas를 백엔드로 쓰며 컬렉션 조회/쿼리/스키마 탐색을 AI로 하고 싶을 때.",
      "tags": {
        "framework": [
          "mongodb",
          "atlas"
        ],
        "lang": [
          "javascript"
        ],
        "task": [
          "database",
          "backend",
          "query"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add mongodb --env MDB_MCP_CONNECTION_STRING=$MDB_MCP_CONNECTION_STRING -- npx -y mongodb-mcp-server@latest",
        "env": [
          "MDB_MCP_CONNECTION_STRING"
        ],
        "secrets": [
          "MDB_MCP_CONNECTION_STRING"
        ]
      },
      "source_url": "https://github.com/mongodb-js/mongodb-mcp-server",
      "popularity": "MongoDB 공식(mongodb-js) repo, npm 정식 배포. 널리 쓰임.",
      "seo": {
        "seoTitle": "MongoDB MCP Server: Claude Code로 MongoDB·Atlas 연결·쿼리",
        "metaDescription": "MongoDB MCP Server는 Claude Code를 MongoDB·Atlas 클러스터에 연결해 컬렉션 탐색·쿼리·read-only 운영을 돕는 공식(mongodb-js) 서버입니다. 설정과 보안 주의점을 정리했습니다.",
        "summary": "MongoDB MCP Server는 MongoDB가 직접 관리하는 공식(mongodb-js) MCP(Model Context Protocol) 서버로, Claude Code 같은 AI 클라이언트를 MongoDB 데이터베이스 및 MongoDB Atlas 클러스터에 연결해 줍니다. 연결 문자열(MDB_MCP_CONNECTION_STRING)로 대상 인스턴스를 지정하면, AI가 데이터베이스·컬렉션 구조를 탐색하고 문서를 조회하거나 쿼리를 실행할 수 있어, 스키마를 일일이 사람이 설명하지 않아도 됩니다.\n\n이 서버가 푸는 문제는 명확합니다. 그동안 AI에게 MongoDB 데이터를 보여주려면 사람이 직접 쿼리를 돌려 결과를 복사해 붙여넣거나, 별도 도구를 만들어야 했습니다. MCP 서버를 붙이면 AI가 자연어 요청을 받아 컬렉션 목록 확인, 인덱스·필드 구조 파악, 필터·집계 쿼리 실행 같은 작업을 직접 수행합니다. 덕분에 \"이 컬렉션 스키마 분석해줘\", \"최근 가입 유저 통계 뽑아줘\" 같은 요청을 코드 작성 단계 없이 처리할 수 있습니다.\n\n핵심 기능으로는 컬렉션·데이터베이스 탐색, 문서 쿼리, 그리고 read-only(읽기 전용) 모드 지원이 있습니다. read-only 모드는 AI가 데이터를 변경하지 못하도록 묶어두는 안전장치로, 운영 DB를 조사·분석 용도로 연결할 때 특히 유용합니다. 자체 호스팅 MongoDB는 물론 클라우드인 Atlas 클러스터에도 연결됩니다.\n\n이 서버는 MongoDB를 백엔드로 쓰는 개발자, 데이터 구조를 빠르게 파악하고 싶은 백엔드·풀스택 엔지니어, 운영 데이터를 안전하게(read-only) 살펴보며 디버깅하거나 리포트를 만들려는 팀에게 적합합니다. 구체적인 설치·인증·도구 목록과 최신 옵션은 버전에 따라 달라질 수 있으므로 공식 GitHub 저장소(mongodb-js/mongodb-mcp-server) 문서 확인을 권장합니다.",
        "whenToUse": "MongoDB나 Atlas를 백엔드로 쓰는 프로젝트에서 AI에게 DB 구조·데이터를 직접 보여주고 싶을 때 적합합니다. 컬렉션 스키마 파악, 쿼리·집계 결과 확인, 운영 데이터 디버깅, 데이터 기반 리포트 작성처럼 사람이 매번 쿼리를 돌려 붙여넣던 작업을 줄여줍니다. 특히 운영 DB는 read-only 모드로 연결해 조사·분석만 안전하게 수행할 때 효과적입니다.",
        "installNotes": "npx로 mongodb-mcp-server를 실행하므로 Node.js 환경이 필요합니다. 연결 대상은 환경변수 MDB_MCP_CONNECTION_STRING(MongoDB 연결 문자열)로 지정하며, 셸에 미리 export해 두거나 클라이언트 환경에 설정해야 합니다. Atlas 연결 시 IP 접근 목록·네트워크 허용, 자체 호스팅 시 인증·네트워크 도달성을 먼저 확인하세요. read-only 등 모드·옵션과 지원 도구는 버전에 따라 달라질 수 있으니 공식 저장소 문서 확인을 권장합니다.",
        "securityNotes": "MDB_MCP_CONNECTION_STRING에는 DB 사용자·비밀번호가 포함되는 경우가 많으므로 비밀키로 취급해 코드·로그·커밋에 노출하지 마세요. 이 서버는 데이터베이스 전체 데이터에 접근할 수 있어, 권한이 넓은 계정을 연결하면 AI가 의도치 않게 민감 데이터를 읽거나(쓰기 허용 시) 변경·삭제할 수 있습니다. 운영 DB는 가급적 read-only 모드 + 최소권한 전용 계정으로 연결하고, 분석은 사본/스테이징에서 수행하길 권장합니다. 또한 DB에 저장된 외부 입력 문서가 프롬프트 인젝션 경로가 될 수 있으니, 조회 결과를 그대로 신뢰해 파괴적 작업을 자동 실행하지 마세요.",
        "faq": [
          {
            "q": "MongoDB Atlas 클러스터에도 연결되나요?",
            "a": "네. 자체 호스팅 MongoDB와 Atlas 클러스터 모두 연결을 지원합니다. Atlas는 연결 문자열과 함께 IP 접근 목록·네트워크 허용 설정이 맞아야 도달할 수 있으며, 구체적 설정은 공식 저장소 문서 확인을 권장합니다."
          },
          {
            "q": "AI가 실수로 데이터를 변경하거나 지우지 않게 할 수 있나요?",
            "a": "read-only(읽기 전용) 모드를 지원하므로 조사·분석 용도로 연결할 때 이를 켜면 쓰기·삭제를 막을 수 있습니다. 더 안전하게는 읽기 전용 권한만 가진 전용 DB 계정을 만들어 연결 문자열에 사용하는 것을 권장합니다."
          },
          {
            "q": "연결 문자열은 어떻게 전달하나요?",
            "a": "환경변수 MDB_MCP_CONNECTION_STRING으로 전달합니다. 자격증명이 포함되므로 비밀키로 취급해 커밋·로그에 노출하지 말고, 셸 export나 클라이언트 환경설정으로 안전하게 주입하세요."
          }
        ],
        "relatedIds": [
          "mcp-postgres-pro",
          "mcp-dbhub",
          "mcp-toolbox-databases"
        ]
      }
    },
    {
      "id": "mcp-neon",
      "type": "mcp",
      "name": "Neon MCP Server",
      "description": "서버리스 Postgres인 Neon을 자연어로 관리하는 공식 MCP 서버. 프로젝트·브랜치·쿼리·마이그레이션을 Neon API로 수행한다.",
      "useWhen": "Neon(서버리스 Postgres)을 쓰며 DB 브랜치 생성, 마이그레이션, 쿼리를 AI로 관리하고 싶을 때.",
      "tags": {
        "framework": [
          "neon",
          "postgresql"
        ],
        "lang": [
          "sql",
          "javascript"
        ],
        "task": [
          "database",
          "backend",
          "migration"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add neon -- npx -y @neondatabase/mcp-server-neon start $NEON_API_KEY",
        "env": [
          "NEON_API_KEY"
        ],
        "secrets": [
          "NEON_API_KEY"
        ]
      },
      "source_url": "https://github.com/neondatabase-labs/mcp-server-neon",
      "popularity": "Neon 공식 labs repo, GitHub 약 600 stars. 서버리스 Postgres 진영에서 표준.",
      "seo": {
        "seoTitle": "Neon MCP Server: Claude Code로 서버리스 Postgres 자연어 관리",
        "metaDescription": "Neon 공식 MCP 서버로 Claude Code에서 서버리스 Postgres의 프로젝트·브랜치·쿼리·마이그레이션을 자연어로 수행하는 방법과 설치·보안 주의점을 정리했습니다.",
        "summary": "Neon MCP Server는 서버리스 Postgres 서비스인 Neon을 Claude Code 같은 MCP 클라이언트에서 자연어로 관리하도록 해주는 공식(Neon Labs) MCP 서버입니다. 평소 Neon 콘솔이나 REST API, psql을 오가며 하던 작업을 AI 에이전트가 Neon API 호출로 대신 수행하게 만드는 다리 역할을 합니다.\n\n핵심적으로 다루는 작업은 네 가지로 요약됩니다. 첫째, 프로젝트(Project) 생성·조회·관리. 둘째, Neon의 특징인 브랜치(Branch) 운영 — 프로덕션 데이터를 복사한 격리 브랜치를 즉석에서 만들어 실험하고, 검증 후 정리하는 흐름을 대화로 처리할 수 있습니다. 셋째, SQL 쿼리 실행 — 테이블 조회·집계 같은 읽기성 작업부터 데이터 변경까지. 넷째, 스키마 마이그레이션 — 테이블/컬럼 변경을 브랜치에서 시험한 뒤 반영하는 패턴이 Neon의 분기 모델과 잘 맞습니다.\n\n이런 워크플로의 이점은 \"DB 콘솔 ↔ 코드 에디터 ↔ 마이그레이션 도구\"를 수동으로 오가던 컨텍스트 전환을 줄이고, 브랜치 기반 안전 실험을 자연어 한두 마디로 시작할 수 있다는 점입니다. 스키마 설계 초안, 샘플 쿼리 작성, 마이그레이션 시나리오 검토 같은 작업에서 특히 유용합니다.\n\n누가 쓰면 좋은가: Neon을 백엔드 DB로 쓰는 풀스택·백엔드 개발자, 브랜치로 안전하게 실험하고 싶은 팀, AI 보조로 마이그레이션 초안을 빠르게 만들고 싶은 사람에게 적합합니다. 단, AI가 생성한 SQL·마이그레이션은 사람이 검토하고 적용하는 것을 전제로 사용하세요. 정확한 지원 도구 목록·인증 방식·원격(remote) 옵션 여부는 버전에 따라 달라질 수 있으니 공식 GitHub 저장소와 Neon 문서를 함께 확인할 것을 권장합니다.",
        "whenToUse": "Neon을 데이터베이스로 사용하는 프로젝트에서, Claude Code에게 프로젝트·브랜치 관리, SQL 쿼리 작성·실행, 스키마 마이그레이션 초안 작성을 맡기고 싶을 때 적합합니다. 특히 프로덕션을 건드리지 않고 브랜치에서 변경을 실험·검증한 뒤 반영하는 흐름, 또는 콘솔·psql·마이그레이션 도구를 오가는 컨텍스트 전환을 줄이고 싶을 때 유용합니다. 일회성 단순 조회보다, 반복적인 DB 작업이 많은 환경에서 가치가 큽니다.",
        "installNotes": "설치 전 Neon 계정과 API 키(NEON_API_KEY)를 발급해 환경변수로 준비해야 합니다. 키는 셸 환경변수나 MCP 클라이언트의 env 설정으로 주입하고, 명령행에 평문으로 남기거나 저장소에 커밋하지 마세요. Node.js(npx) 실행 환경이 필요합니다. 등록 후 Claude Code에서 MCP 서버가 정상 연결됐는지, 노출되는 도구 목록이 의도대로인지 확인하세요. 원격(remote) 연결·OAuth 등 대안 방식이나 지원 도구 범위는 버전에 따라 다를 수 있으므로 공식 GitHub 저장소와 Neon 문서를 확인하는 것을 권장합니다.",
        "securityNotes": "이 서버는 NEON_API_KEY로 Neon 계정에 접근하므로, 키 권한 범위가 곧 노출 범위입니다. API 키는 프로젝트 생성·삭제, 브랜치 조작, SQL 실행 등 광범위한 작업을 수행할 수 있어 유출 시 데이터 손실·과금·삭제 위험으로 이어집니다. 키는 환경변수로만 다루고 절대 커밋·로그·출력하지 마세요. AI가 생성한 DELETE/DROP/TRUNCATE나 마이그레이션은 사람이 검토 후 적용하고, 가능하면 프로덕션이 아닌 브랜치에서 먼저 검증하세요. DB에 저장된 외부 입력(사용자 콘텐츠 등)이 쿼리 결과로 모델에 전달되면 prompt injection 가능성이 있으니 신뢰할 수 없는 데이터 처리 시 주의가 필요합니다.",
        "faq": [
          {
            "q": "Neon MCP Server는 무엇을 할 수 있나요?",
            "a": "Neon API를 통해 프로젝트 생성·조회, 브랜치 생성·관리, SQL 쿼리 실행, 스키마 마이그레이션 같은 작업을 Claude Code에서 자연어로 수행할 수 있습니다. 콘솔이나 psql을 직접 열지 않고 대화로 DB 작업을 진행하려는 용도에 맞습니다."
          },
          {
            "q": "사용하려면 무엇이 필요한가요?",
            "a": "Neon 계정과 NEON_API_KEY가 필요하며, npx 실행을 위한 Node.js 환경이 있어야 합니다. 키는 환경변수로 주입하고 저장소에 커밋하지 마세요. 인증 방식과 지원 도구 범위는 버전에 따라 다를 수 있어 공식 문서 확인을 권장합니다."
          },
          {
            "q": "AI가 프로덕션 데이터를 실수로 망가뜨릴 위험은 없나요?",
            "a": "API 키 권한 범위 내에서 삭제·변경이 가능하므로 위험이 존재합니다. Neon의 브랜치 기능으로 격리된 환경에서 먼저 검증하고, AI가 만든 파괴적 SQL이나 마이그레이션은 반드시 사람이 검토한 뒤 적용하는 것을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-supabase",
          "mcp-postgres-pro",
          "mcp-dbhub"
        ]
      }
    },
    {
      "id": "mcp-clickhouse",
      "type": "mcp",
      "name": "ClickHouse MCP Server",
      "description": "ClickHouse(컬럼형 OLAP DB)에 연결해 자연어 쿼리와 스키마 탐색을 제공하는 공식 MCP 서버.",
      "useWhen": "ClickHouse를 분석/로그 DB로 쓰며 대용량 데이터를 AI로 조회·분석하고 싶을 때.",
      "tags": {
        "framework": [
          "clickhouse"
        ],
        "lang": [
          "sql",
          "python"
        ],
        "task": [
          "database",
          "analytics",
          "query"
        ]
      },
      "install": {
        "method": "manual",
        "command": "uv 기반 설치 후 CLICKHOUSE_HOST/PORT/USER/PASSWORD 환경변수로 연결. 정확한 명령은 공식 문서 참조.",
        "env": [
          "CLICKHOUSE_HOST",
          "CLICKHOUSE_USER",
          "CLICKHOUSE_PASSWORD"
        ],
        "secrets": [
          "CLICKHOUSE_HOST",
          "CLICKHOUSE_USER",
          "CLICKHOUSE_PASSWORD"
        ]
      },
      "source_url": "https://github.com/ClickHouse/mcp-clickhouse",
      "popularity": "ClickHouse 공식 repo. OLAP/분석 DB MCP의 대표격.",
      "seo": {
        "seoTitle": "ClickHouse MCP Server: 컬럼형 OLAP DB 자연어 쿼리·스키마 탐색",
        "metaDescription": "ClickHouse MCP Server는 컬럼형 OLAP 데이터베이스에 연결해 자연어 질의와 스키마 탐색을 지원하는 공식 MCP 서버입니다. Claude가 대규모 분석 데이터를 SQL로 조회하도록 돕습니다.",
        "summary": "ClickHouse MCP Server는 ClickHouse(컬럼형 OLAP 데이터베이스)에 Claude Code 같은 MCP 클라이언트를 연결해 주는 ClickHouse 공식 MCP 서버입니다. AI 에이전트가 자연어로 표현한 분석 의도를 SQL 질의로 옮겨 실행하고, 데이터베이스·테이블·컬럼 등 스키마를 탐색하도록 도구를 제공합니다. 이를 통해 사람이 매번 콘솔에 접속해 쿼리를 손으로 작성하지 않아도, 대화 흐름 안에서 데이터를 조회하고 결과를 받아볼 수 있습니다.\n\n이 서버가 푸는 핵심 문제는 \"대규모 분석 데이터에 대한 탐색적 질의의 진입 장벽\"입니다. ClickHouse는 로그·이벤트·텔레메트리·웹 트래픽 같은 대용량 시계열/분석 데이터를 빠르게 집계하는 데 강점이 있는데, 막상 스키마가 크고 테이블이 많으면 어떤 컬럼이 있고 어떻게 조인해야 하는지 파악하는 데 시간이 듭니다. MCP 서버는 스키마 탐색 도구로 구조를 먼저 보여주고, 그 맥락 위에서 AI가 적절한 쿼리를 만들어 실행하도록 해 분석 반복(iteration) 속도를 높입니다.\n\n주요 기능은 (1) ClickHouse 인스턴스 연결(호스트/포트/사용자/비밀번호 환경변수 기반), (2) 데이터베이스·테이블·컬럼 스키마 조회, (3) SQL 질의 실행과 결과 반환입니다. 정확한 도구 목록·동작·읽기 전용 여부 등 세부 사항은 버전에 따라 다를 수 있으므로 공식 저장소(github.com/ClickHouse/mcp-clickhouse) 문서 확인을 권장합니다.\n\n누가 쓰면 좋은가: ClickHouse를 운영 중인 데이터 엔지니어·분석가, 로그/이벤트 분석 파이프라인을 다루는 백엔드 개발자, 그리고 AI 어시스턴트를 통해 애드혹(ad-hoc) 데이터 질의를 자주 하고 싶은 팀에 적합합니다. 설치는 uv 기반으로 진행하며 연결 정보를 환경변수로 주입하는 방식입니다(정확한 명령은 공식 문서 참조).",
        "whenToUse": "ClickHouse에 쌓인 로그·이벤트·트래픽 등 대용량 분석 데이터를 AI와의 대화 흐름에서 바로 조회·집계하고 싶을 때, 또는 테이블이 많아 스키마 파악과 쿼리 작성에 시간이 들 때 적합합니다. 애드혹 분석, 데이터 탐색, 리포트 초안 작성 보조에 유용합니다. 트랜잭션 위주 OLTP 워크로드나 ClickHouse를 쓰지 않는 환경에는 맞지 않습니다.",
        "installNotes": "uv 기반으로 설치한 뒤 CLICKHOUSE_HOST/PORT/USER/PASSWORD 환경변수로 대상 인스턴스를 지정해 연결합니다. 정확한 패키지명·실행 명령·지원 도구 범위는 버전에 따라 달라질 수 있으니 공식 저장소(github.com/ClickHouse/mcp-clickhouse) 문서 확인을 권장합니다. 사내 ClickHouse라면 방화벽/네트워크 접근 권한과 TLS 설정도 함께 확인하세요. MCP 클라이언트(Claude Code 등) 설정 파일에 서버를 등록해야 도구가 노출됩니다.",
        "securityNotes": "CLICKHOUSE_HOST·CLICKHOUSE_USER·CLICKHOUSE_PASSWORD 등 DB 접속 자격증명을 다루므로 비밀번호는 환경변수/시크릿 매니저로만 주입하고 코드·로그·커밋에 노출하지 마세요. AI가 SQL을 생성·실행하는 구조이므로, 가능하면 권한이 제한된 읽기 전용(read-only) 계정과 최소 권한 원칙을 적용해 DROP/TRUNCATE/DELETE 등 파괴적 쿼리 위험을 차단하는 것을 권장합니다. 운영 DB 직접 연결은 신중히 하고, 외부에서 들어온 텍스트(테이블 내용·컬럼명)가 프롬프트 인젝션 경로가 될 수 있으니 자동 실행 범위를 통제하세요.",
        "faq": [
          {
            "q": "ClickHouse MCP Server는 무엇을 하나요?",
            "a": "ClickHouse(컬럼형 OLAP DB)에 MCP 클라이언트를 연결해, 자연어 의도를 SQL 질의로 실행하고 데이터베이스·테이블·컬럼 스키마를 탐색하도록 도구를 제공하는 공식 MCP 서버입니다."
          },
          {
            "q": "운영 데이터베이스에 바로 연결해도 되나요?",
            "a": "가능하지만 권장 방식은 읽기 전용·최소 권한 계정 사용입니다. AI가 SQL을 생성·실행하므로 파괴적 쿼리 위험을 줄이려면 권한을 제한하고 자동 실행 범위를 통제하세요. 자세한 설정은 공식 문서 확인을 권장합니다."
          },
          {
            "q": "어떻게 설치하나요?",
            "a": "uv 기반으로 설치한 뒤 CLICKHOUSE_HOST/PORT/USER/PASSWORD 환경변수로 연결합니다. 정확한 명령과 패키지명은 버전에 따라 다를 수 있어 공식 저장소 문서를 참고하세요."
          }
        ],
        "relatedIds": [
          "mcp-postgres-pro",
          "mcp-toolbox-databases",
          "mcp-dbhub"
        ]
      }
    },
    {
      "id": "mcp-toolbox-databases",
      "type": "mcp",
      "name": "MCP Toolbox for Databases (Google)",
      "description": "단일 서버로 PostgreSQL·MySQL·SQL Server·MongoDB·Redis·BigQuery·Spanner 등 다수 DB를 지원하는 Google 오픈소스 MCP 서버.",
      "useWhen": "여러 종류의 DB를 하나의 MCP 서버로 다루거나, Google Cloud(BigQuery/Spanner/Cloud SQL) 기반 백엔드를 AI로 연결할 때.",
      "tags": {
        "framework": [
          "postgresql",
          "mysql",
          "bigquery",
          "spanner",
          "redis",
          "mongodb"
        ],
        "lang": [
          "sql",
          "go"
        ],
        "task": [
          "database",
          "backend",
          "multi-db",
          "query"
        ]
      },
      "install": {
        "method": "manual",
        "command": "Toolbox 바이너리 다운로드 후 tools.yaml로 DB 연결 정의 → stdio 모드로 MCP 연결. 정확한 명령은 공식 문서(mcp-toolbox.dev) 참조.",
        "env": []
      },
      "source_url": "https://github.com/googleapis/genai-toolbox",
      "popularity": "Google(googleapis) 공식 오픈소스. 다중 DB 지원으로 빠르게 채택, stars 수천 추정.",
      "seo": {
        "seoTitle": "MCP Toolbox for Databases (Google) — 다중 DB 통합 MCP 서버 설치·연결 가이드",
        "metaDescription": "Google 오픈소스 MCP Toolbox for Databases는 PostgreSQL·MySQL·BigQuery·Spanner 등 다수 DB를 단일 서버로 연결한다. tools.yaml 설정, 핵심 기능, 보안 주의점을 정리.",
        "summary": "MCP Toolbox for Databases는 Google(googleapis)이 공개한 오픈소스 MCP 서버로, 여러 종류의 데이터베이스를 하나의 서버로 연결해 AI 에이전트가 쿼리·탐색하도록 해준다. PostgreSQL·MySQL·MariaDB·SQL Server·Oracle·MongoDB·Redis·Elasticsearch·ClickHouse·Neo4j·Snowflake 등 폭넓은 DB와, Google Cloud 계열인 AlloyDB·BigQuery·Cloud SQL·Spanner·Firestore까지 지원한다(지원 목록은 버전에 따라 갱신되므로 공식 문서 확인 권장).\n\n해결하는 문제는 \"DB마다 별도 MCP 서버를 따로 띄우고 관리하는 번거로움\"이다. 여러 데이터 소스를 다뤄야 하는 환경에서 단일 Toolbox 인스턴스에 연결 정의를 모아두면, 도구 정의·인증·연결 풀링·관측성(OpenTelemetry)을 한 곳에서 일관되게 관리할 수 있다.\n\n핵심은 tools.yaml 매니페스트다. 이 파일은 Sources(DB 연결 정보), Tools(에이전트가 수행할 구조화된 쿼리·검색 동작), Toolsets(도구 묶음), Prompts(LLM 상호작용 템플릿) 네 영역으로 구성된다. 또한 별도 정의 없이 list_tables·execute_sql 같은 제네릭 도구로 즉시 데이터 탐색을 시작하는 prebuilt 모드도 제공한다. 본체는 Go로 작성되어 단일 바이너리로 배포되며, LangChain·LlamaIndex 등 프레임워크와도 SDK로 연동된다.\n\n쓰면 좋은 경우: 이기종 DB를 동시에 다루는 백엔드/데이터 팀, 임의 SQL 실행 대신 미리 정의한 안전한 쿼리 도구만 에이전트에 노출하고 싶을 때, 연결 풀링·인증·관측성을 갖춘 운영급 MCP 게이트웨이가 필요할 때다. Claude Code 등 MCP 클라이언트는 Toolbox가 노출하는 MCP 엔드포인트에 연결해 사용한다.",
        "whenToUse": "여러 종류의 DB(예: PostgreSQL + BigQuery + MongoDB)를 하나의 MCP 서버로 묶어 다루고 싶을 때, 에이전트에 임의 SQL을 통째로 주기보다 tools.yaml로 미리 정의한 안전한 쿼리 도구만 노출하고 싶을 때, 연결 풀링·인증·OpenTelemetry 관측성을 갖춘 운영급 DB 게이트웨이가 필요할 때 적합하다. 단일 DB만 쓰고 빠른 탐색이 목적이면 prebuilt 제네릭 도구 모드로도 충분하다.",
        "installNotes": "설치는 패키지 매니저가 아니라 Toolbox 바이너리를 직접 받아 실행하는 방식이다(Go 단일 바이너리). 핵심은 tools.yaml 작성으로, Sources에 각 DB 연결 정보를, Tools/Toolsets에 노출할 동작을 정의한 뒤 stdio 또는 HTTP 모드로 MCP 클라이언트에 연결한다. 지원 DB 목록·드라이버·정확한 실행 옵션은 버전마다 다르므로 공식 문서(mcp-toolbox.dev, github.com/googleapis/genai-toolbox)를 반드시 확인할 것. prebuilt 모드는 정의 없이 빠른 탐색용이다.",
        "securityNotes": "tools.yaml의 Sources에는 DB 호스트·계정·비밀번호 등 자격증명이 들어가므로 평문 커밋을 금지하고 환경변수·시크릿 매니저로 분리하라. execute_sql 등 제네릭 도구나 광범위한 권한 계정을 그대로 노출하면 에이전트가 데이터 조회를 넘어 UPDATE·DROP·TRUNCATE 같은 파괴적 작업이나 과금성 쿼리(예: BigQuery 풀스캔)를 수행할 수 있으니, 읽기 전용 계정·최소 권한·허용 쿼리 화이트리스트를 우선한다. DB가 반환한 데이터에 포함된 지시문이 프롬프트 인젝션으로 작용할 수 있으므로 결과를 신뢰 입력으로 다루지 말 것. 네트워크 노출 시 인증·접근통제를 반드시 적용하라.",
        "faq": [
          {
            "q": "단일 DB만 쓰는데 굳이 필요할까?",
            "a": "단일 DB면 해당 DB 전용 MCP 서버(예: Postgres·MongoDB 서버)로도 충분하다. Toolbox는 여러 이기종 DB를 한 서버로 묶거나, 연결 풀링·인증·관측성·정의형 도구 노출이 필요한 운영 환경에서 이점이 크다."
          },
          {
            "q": "임의 SQL을 막고 정해진 쿼리만 허용할 수 있나?",
            "a": "가능하다. tools.yaml의 Tools에 구조화된 쿼리를 미리 정의해 노출하면 에이전트는 그 도구만 호출한다. 반대로 prebuilt 모드의 execute_sql은 자유 SQL을 허용하므로 권한·계정 범위를 함께 제한해야 한다."
          },
          {
            "q": "Google Cloud 전용인가?",
            "a": "아니다. AlloyDB·BigQuery·Spanner 등 Google Cloud 계열뿐 아니라 PostgreSQL·MySQL·SQL Server·MongoDB·Redis 등 범용 DB도 지원한다. 최신 지원 목록은 공식 문서 확인을 권장한다."
          }
        ],
        "relatedIds": [
          "mcp-postgres-pro",
          "mcp-dbhub",
          "mcp-mongodb"
        ]
      }
    },
    {
      "id": "mcp-dbhub",
      "type": "mcp",
      "name": "DBHub (Universal Database Gateway)",
      "description": "MySQL·PostgreSQL·SQL Server·MariaDB·SQLite·Oracle 등을 단일 인터페이스로 연결하는 범용 DB 게이트웨이 MCP 서버.",
      "useWhen": "여러 종류의 관계형 DB를 하나의 MCP 서버로 통일해 조회/탐색하고 싶을 때(특정 벤더 종속 회피).",
      "tags": {
        "framework": [
          "postgresql",
          "mysql",
          "sqlite",
          "mariadb",
          "sqlserver"
        ],
        "lang": [
          "sql",
          "typescript"
        ],
        "task": [
          "database",
          "multi-db",
          "query"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add dbhub -- npx -y @bytebase/dbhub --dsn $DATABASE_DSN  (DSN으로 대상 DB 지정; 정확한 옵션은 공식 repo 참조)",
        "env": [
          "DATABASE_DSN"
        ],
        "secrets": [
          "DATABASE_DSN"
        ]
      },
      "source_url": "https://github.com/bytebase/dbhub",
      "popularity": "Bytebase가 만든 범용 DB MCP. 다중 RDBMS 지원으로 awesome-mcp 다수 등재.",
      "seo": {
        "seoTitle": "DBHub MCP 서버 — 여러 DB를 한 번에 연결하는 범용 게이트웨이",
        "metaDescription": "DBHub는 PostgreSQL·MySQL·MariaDB·SQL Server·SQLite를 단일 인터페이스로 연결하는 범용 데이터베이스 게이트웨이 MCP 서버입니다. DSN 기반 연결, 스키마 탐색, 읽기 전용 모드를 지원합니다.",
        "summary": "DBHub(@bytebase/dbhub)는 Bytebase가 만든 범용 데이터베이스 게이트웨이 MCP 서버입니다. Claude Code 같은 AI 클라이언트가 여러 종류의 관계형 데이터베이스에 같은 방식으로 접근하도록 단일 인터페이스를 제공합니다. 공식 저장소 기준으로 PostgreSQL·MySQL·MariaDB·SQL Server·SQLite를 지원하며, 연결은 표준 DSN(예: postgres://user:password@host:port/dbname) 문자열 하나로 지정합니다(Oracle 등 추가 지원 여부는 버전에 따라 다를 수 있으니 공식 문서 확인 권장).\n\nDBHub가 푸는 문제는 \"DB마다 다른 MCP 서버·다른 연결 방식을 따로 붙여야 하는 번거로움\"입니다. DB 종류가 바뀌어도 DSN만 교체하면 동일한 도구 세트(SQL 실행, 스키마/테이블/컬럼/인덱스/프로시저 탐색 등)를 그대로 쓸 수 있어, AI가 데이터 구조를 파악하고 쿼리를 작성·실행하는 흐름을 한 곳에서 처리합니다. 트랜잭션을 지원하는 SQL 실행과 함께, 읽기 전용 모드·행 수 제한(row limit)·쿼리 타임아웃 같은 안전장치를 제공해 의도치 않은 대량 변경이나 폭주 쿼리를 막습니다. 또한 stdio·HTTP·SSE 세 가지 전송 모드, SSH 터널링과 SSL/TLS 암호화, 다중 DB 동시 연결, 시각적 점검용 웹 워크벤치 등을 갖추고 있습니다.\n\n여러 데이터베이스(예: 운영 PostgreSQL과 로컬 SQLite, 레거시 MySQL)를 동시에 다루는 개발자, AI에게 스키마를 탐색시키고 분석 쿼리를 맡기려는 데이터 엔지니어, 환경마다 DB 종류가 다른 팀에게 적합합니다. 특정 DB에 깊은 진단·튜닝이 필요하면 전용 서버(Postgres MCP Pro 등)가 더 알맞을 수 있습니다.",
        "whenToUse": "여러 종류의 관계형 DB(PostgreSQL·MySQL·MariaDB·SQL Server·SQLite)를 하나의 MCP 인터페이스로 묶어 AI에게 스키마 탐색과 쿼리 실행을 맡기고 싶을 때 적합합니다. 환경마다 DB 종류가 달라 DSN만 바꿔 재사용하고 싶거나, AI에게 운영 데이터를 안전하게(읽기 전용·행 제한) 조회시키려는 경우에 유용합니다. 단일 DB에 특화된 깊은 튜닝이 목적이면 전용 서버를 함께 고려하세요.",
        "installNotes": "npx로 실행되므로 Node.js 환경이 필요합니다. 대상 DB는 DATABASE_DSN(또는 --dsn) 한 줄로 지정하며, DB 종류별 드라이버 형식(postgres://, mysql://, sqlite:// 등)이 다르니 정확한 DSN·옵션은 공식 저장소를 확인하세요. 읽기 전용 모드·행 제한·쿼리 타임아웃은 옵션으로 켜는 안전장치이며 기본값은 버전에 따라 다를 수 있습니다. HTTP 전송은 기본 0.0.0.0에 바인딩되고 HTTP 클라이언트 인증을 하지 않으므로, 외부 노출 시 127.0.0.1 바인딩 + 리버스 프록시가 권장됩니다.",
        "securityNotes": "DATABASE_DSN에는 DB 사용자명·비밀번호·호스트가 그대로 들어가므로 최고 등급 비밀로 취급하세요(커밋·로그·출력 금지, 환경변수/시크릿 매니저 사용). AI가 임의 SQL을 실행할 수 있어, 운영 DB 연결 시 반드시 읽기 전용 모드를 켜고 최소 권한 계정을 별도로 발급하는 것을 권장합니다(쓰기 권한 계정 연결 시 INSERT/UPDATE/DELETE·DROP 등 파괴적 작업이나 대량 변경 위험). DB에 저장된 텍스트(레코드 값·코멘트)에 악의적 지시가 섞여 프롬프트 인젝션으로 이어질 수 있으니, 조회 결과를 신뢰된 명령으로 그대로 따르지 않도록 주의하세요. HTTP 전송은 인증이 없으므로 외부에 노출하지 말고 로컬 바인딩+프록시로 보호하세요.",
        "faq": [
          {
            "q": "DBHub는 어떤 데이터베이스를 지원하나요?",
            "a": "공식 저장소 기준 PostgreSQL·MySQL·MariaDB·SQL Server·SQLite를 지원하며, 표준 DSN 문자열로 연결합니다. 그 외 DB(예: Oracle) 지원 여부는 버전에 따라 다를 수 있으니 공식 문서를 확인하세요."
          },
          {
            "q": "AI가 실수로 데이터를 바꾸지 않게 하려면?",
            "a": "읽기 전용 모드를 켜고, 행 수 제한·쿼리 타임아웃 같은 안전장치를 활용하세요. 추가로 DB 측에서 SELECT만 가능한 최소 권한 계정을 따로 발급해 DSN에 연결하는 것이 안전합니다."
          },
          {
            "q": "여러 DB를 동시에 연결할 수 있나요?",
            "a": "네, 다중 DB 동시 연결을 지원합니다. 또한 stdio·HTTP·SSE 전송 모드와 SSH 터널링·SSL/TLS를 제공합니다. 자세한 설정은 공식 저장소를 참고하세요."
          }
        ],
        "relatedIds": [
          "mcp-postgres-pro",
          "mcp-toolbox-databases",
          "mcp-supabase"
        ]
      }
    },
    {
      "id": "mcp-notion",
      "type": "mcp",
      "name": "Notion MCP Server (공식)",
      "description": "Notion 워크스페이스의 페이지·데이터베이스·댓글을 AI가 읽고 쓸 수 있게 하는 공식 MCP 서버. makenotion에서 직접 유지보수.",
      "useWhen": "문서/위키/지식베이스를 Notion으로 관리하고, 블로그 초안·운영 노트·자료를 Claude로 작성/조회/정리하고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "productivity",
          "docs",
          "knowledge-base",
          "collaboration"
        ]
      },
      "install": {
        "method": "npx",
        "command": "claude mcp add notion -- npx -y @notionhq/notion-mcp-server",
        "env": [
          "NOTION_TOKEN"
        ],
        "secrets": [
          "NOTION_TOKEN"
        ]
      },
      "source_url": "https://github.com/makenotion/notion-mcp-server",
      "popularity": "Notion 공식(makenotion) reference server, 널리 쓰임",
      "seo": {
        "seoTitle": "Notion MCP Server (공식) — Claude가 Notion 페이지·DB 읽고 쓰기",
        "metaDescription": "Notion 공식 MCP 서버 설치·연동 가이드. Claude Code 등 AI가 Notion 워크스페이스의 페이지·데이터베이스·댓글을 읽고 쓰도록 NOTION_TOKEN으로 연결합니다.",
        "summary": "Notion MCP Server는 Notion을 만든 makenotion에서 직접 유지보수하는 공식 MCP(Model Context Protocol) 서버로, Claude Code 같은 MCP 호환 AI 클라이언트가 Notion 워크스페이스의 페이지·데이터베이스·댓글을 직접 읽고 쓸 수 있게 연결해 줍니다. 그동안 \"노트는 Notion에, 작업은 AI 도구에\"로 흩어져 있던 흐름을 하나로 묶어, 대화 중에 AI가 회의록을 페이지로 정리하거나, 데이터베이스 항목을 조회·생성·수정하고, 특정 페이지에 댓글을 남기는 일을 사람이 창을 오가지 않고 처리할 수 있게 합니다.\n\n핵심적으로 해결하는 문제는 \"지식이 Notion에 쌓여 있는데 AI는 그걸 모른다\"는 단절입니다. MCP 서버를 연결하면 AI가 사내 위키·프로젝트 보드·문서를 컨텍스트로 활용해 답하거나, 반대로 정리한 결과를 Notion에 곧바로 적재할 수 있습니다. 대표적인 활용은 회의·리서치 내용 요약 후 페이지 생성, 데이터베이스 기반 태스크/이슈 트래킹의 조회·갱신, 문서 초안 작성과 협업용 댓글 달기, 흩어진 노트의 검색·통합 등입니다.\n\n이 서버는 npx 방식으로 가볍게 추가할 수 있으며 인증에는 Notion 통합(integration) 토큰인 NOTION_TOKEN이 필요합니다. 토큰이 접근할 수 있는 페이지·데이터베이스의 범위는 Notion 쪽 통합 공유 설정에 따라 정해지므로, 연동 전에 어떤 공간을 노출할지 명확히 정해 두는 것이 중요합니다.\n\n추천 사용자: 개인 지식관리(PKM)·문서·위키를 Notion으로 운영하는 개인, 프로젝트 문서와 태스크 보드를 Notion에서 관리하는 팀, AI에게 사내 문서 컨텍스트를 주거나 정리 결과를 자동 적재하고 싶은 운영·콘텐츠·개발 실무자입니다. 정확한 도구 목록·인증 옵션·원격(remote) 연결 방식은 버전에 따라 달라질 수 있으니 공식 GitHub 저장소(makenotion/notion-mcp-server) 문서를 함께 확인하는 것을 권장합니다.",
        "whenToUse": "팀·개인 지식과 문서가 Notion에 모여 있고, AI가 그 내용을 컨텍스트로 활용하거나 정리 결과를 곧바로 Notion에 적재하길 원할 때 적합합니다. 회의록·리서치 요약을 페이지로 만들기, Notion 데이터베이스 기반 태스크/이슈 조회·생성·수정, 문서 초안 작성과 협업 댓글 달기, 위키 검색·통합 같은 워크플로에 특히 유용합니다. 반대로 단순 일회성 메모나 Notion을 쓰지 않는 환경이라면 굳이 필요하지 않습니다.",
        "installNotes": "설치 후 환경변수 NOTION_TOKEN(Notion 통합 토큰)이 필요합니다. Notion에서 internal integration을 만들어 토큰을 발급한 뒤, AI가 접근해야 하는 페이지·데이터베이스를 해당 통합과 공유(Connections 추가)해야 도구가 실제로 보입니다. 공유되지 않은 공간은 토큰이 있어도 접근되지 않습니다. npx 실행에는 Node.js 환경이 필요하며, 도구 목록·원격 연결 등 세부 옵션은 버전에 따라 다를 수 있으니 공식 저장소(makenotion/notion-mcp-server) 문서 확인을 권장합니다.",
        "securityNotes": "NOTION_TOKEN은 워크스페이스 데이터 접근 자격증명이므로 평문 노출·커밋을 금지하고 환경변수나 시크릿 매니저로만 관리하세요. 토큰이 공유받은 모든 페이지·DB에 AI가 읽기·쓰기·수정·삭제할 수 있으니 최소 권한 원칙으로 꼭 필요한 공간만 통합과 공유하고, 민감 문서가 든 공간은 분리하는 것이 안전합니다. 외부에서 들어온 페이지·댓글 내용에 악의적 지시가 섞이는 프롬프트 인젝션 위험이 있으므로, AI가 그 내용을 근거로 페이지 생성·수정 등 쓰기 동작을 할 때는 검토 단계를 두길 권장합니다. 토큰 유출 시 즉시 회전(재발급)하세요.",
        "faq": [
          {
            "q": "설치하려면 무엇이 필요한가요?",
            "a": "Node.js 환경과 Notion 통합 토큰(NOTION_TOKEN)이 필요합니다. Notion에서 internal integration을 만들어 토큰을 발급하고, AI가 다룰 페이지·데이터베이스를 그 통합과 공유해야 실제로 접근됩니다."
          },
          {
            "q": "AI가 내 Notion 전체를 보게 되나요?",
            "a": "아닙니다. 발급한 통합 토큰이 공유받은 페이지·데이터베이스에만 접근합니다. Notion의 Connections 설정에서 공유 범위를 조절할 수 있으므로 필요한 공간만 연결하는 것이 안전합니다."
          },
          {
            "q": "읽기뿐 아니라 쓰기도 되나요?",
            "a": "네. 권한이 부여된 범위 안에서 페이지·데이터베이스 항목 생성·수정과 댓글 작성이 가능합니다. 쓰기·삭제 동작은 되돌리기 어려울 수 있으니 중요한 변경은 검토 후 실행하길 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-linear",
          "mcp-atlassian",
          "mcp-slack"
        ]
      }
    },
    {
      "id": "mcp-linear",
      "type": "mcp",
      "name": "Linear MCP Server (공식 원격)",
      "description": "Linear의 이슈·프로젝트·사이클·댓글을 읽고 조작하는 공식 원격 MCP 서버. Linear가 호스팅하며 OAuth 인증, API 키 불필요.",
      "useWhen": "이슈 트래킹/스프린트 관리를 Linear로 하고, 이슈 생성·조회·상태 변경을 Claude로 자동화하고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "issue-tracking",
          "project-management",
          "collaboration"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add --transport http linear https://mcp.linear.app/mcp",
        "env": []
      },
      "source_url": "https://linear.app/docs/mcp",
      "popularity": "Linear 공식 호스티드 서버, 널리 쓰임",
      "seo": {
        "seoTitle": "Linear MCP Server (공식 원격) — Claude로 이슈·프로젝트 관리 자동화",
        "metaDescription": "Linear가 직접 호스팅하는 공식 원격 MCP 서버. OAuth 인증으로 API 키 없이 Claude Code에서 이슈·프로젝트·사이클·댓글을 읽고 조작합니다. 설치·권한·보안 주의점 정리.",
        "summary": "Linear MCP Server는 이슈 트래킹·프로젝트 관리 도구 Linear가 직접 운영하는 공식 원격(remote) MCP 서버입니다. Linear의 워크스페이스에 들어 있는 이슈, 프로젝트, 사이클(스프린트), 댓글 등을 Claude Code 같은 MCP 클라이언트가 읽고 조작할 수 있게 연결합니다. 로컬에 패키지를 설치하거나 별도 서버를 띄울 필요 없이 Linear가 호스팅하는 HTTP 엔드포인트(https://mcp.linear.app/mcp)에 접속하는 방식이라 운영 부담이 작습니다.\n\n가장 큰 특징은 인증 방식입니다. 개인 API 키를 직접 발급해 환경 변수에 넣는 대신 OAuth 흐름으로 워크스페이스 접근을 허용하므로, 별도의 API 키를 코드나 설정 파일에 보관할 필요가 없습니다. 최초 연결 시 브라우저에서 Linear 계정으로 인가하면 됩니다.\n\n이 서버를 붙이면 자연어로 \"이번 사이클에 열려 있는 버그 이슈를 우선순위순으로 보여줘\", \"이 작업에 새 이슈를 만들고 나에게 할당해줘\", \"해당 이슈에 진행 상황 댓글을 달아줘\" 같은 요청을 처리할 수 있습니다. 즉 이슈 조회·생성·수정, 상태/담당자 변경, 사이클·프로젝트 단위 조회, 댓글 작성 등 팀의 일상적인 워크플로를 대화로 다룰 수 있게 됩니다.\n\n코드 리뷰나 개발 중 발견한 작업을 곧바로 이슈로 등록하고 싶은 엔지니어, 스프린트 현황을 빠르게 요약·정리하려는 PM, 반복적인 트리아지·라벨링을 자동화하려는 팀에게 적합합니다. 정확한 지원 도구 목록과 권한 범위, OAuth 절차는 버전에 따라 달라질 수 있으니 공식 문서(linear.app/docs/mcp) 확인을 권장합니다.",
        "whenToUse": "개발·작업 흐름 안에서 Linear 이슈를 자연어로 다루고 싶을 때 적합합니다. 코드 작업 중 발견한 버그를 바로 이슈로 등록하거나, 현재 사이클·프로젝트 현황을 요약하고, 담당자·상태를 일괄 정리하거나, 이슈에 진행 댓글을 자동으로 남기는 작업에 유용합니다. 로컬 설치 없이 OAuth로 빠르게 붙이고 싶은 Linear 사용 팀에 권장합니다.",
        "installNotes": "원격(HTTP transport) MCP 서버이므로 로컬 패키지 설치는 필요 없고, 등록 후 최초 연결 시 브라우저에서 Linear 계정으로 OAuth 인가를 한 번 거쳐야 합니다. 인가된 워크스페이스/계정 권한 범위 안에서만 동작하므로, 권한이 부족하면 일부 조회·수정이 실패할 수 있습니다. 엔드포인트 URL과 지원 도구·인가 절차는 Linear 측 변경에 따라 달라질 수 있으니 공식 문서(linear.app/docs/mcp)를 확인하세요. env로 넣어야 할 비밀키는 없습니다.",
        "securityNotes": "별도 API 키를 설정 파일에 보관하지 않고 OAuth로 인증하므로 키 유출 위험은 낮지만, 인가 시 연결된 계정 권한으로 워크스페이스의 이슈·프로젝트·댓글에 접근하게 됩니다. 즉 이 서버는 단순 조회뿐 아니라 이슈 생성·수정·상태 변경·댓글 작성 등 쓰기 작업도 수행할 수 있으므로, 에이전트가 의도치 않게 이슈를 변경·생성하지 않도록 작업 범위를 명확히 지시하세요. 이슈 제목·본문·댓글에 담긴 외부 입력이 프롬프트 인젝션 경로가 될 수 있으니 신뢰할 수 없는 내용은 그대로 실행 지시로 받아들이지 말아야 합니다. 워크스페이스 데이터(고객·내부 정보 포함 가능)가 모델로 전달될 수 있다는 점도 고려하고, 최소 권한 계정으로 인가하길 권장합니다.",
        "faq": [
          {
            "q": "별도 API 키 발급이 필요한가요?",
            "a": "아니요. OAuth 인증을 사용하므로 개인 API 키를 발급해 설정에 넣을 필요가 없습니다. 최초 연결 시 브라우저에서 Linear 계정으로 인가하면 됩니다."
          },
          {
            "q": "이슈를 읽기만 하나요, 생성·수정도 가능한가요?",
            "a": "읽기뿐 아니라 이슈·프로젝트·사이클 조회와 이슈 생성·수정, 댓글 작성 등 쓰기 작업도 가능합니다. 인가된 계정 권한 범위 안에서 동작하며, 의도치 않은 변경을 막으려면 작업 범위를 명확히 지시하세요. 정확한 지원 범위는 공식 문서 확인을 권장합니다."
          },
          {
            "q": "로컬에 따로 설치하거나 서버를 띄워야 하나요?",
            "a": "아니요. Linear가 호스팅하는 원격(HTTP) MCP 서버라 로컬 패키지 설치나 별도 프로세스 실행 없이 엔드포인트에 연결만 하면 됩니다."
          }
        ],
        "relatedIds": [
          "mcp-atlassian",
          "mcp-asana",
          "mcp-notion"
        ]
      }
    },
    {
      "id": "mcp-sentry",
      "type": "mcp",
      "name": "Sentry MCP Server (공식 원격)",
      "description": "Sentry의 이슈·에러 리포트·트레이스·성능 데이터를 조회하는 공식 원격 MCP 서버. getsentry가 직접 운영.",
      "useWhen": "프로덕션 에러/예외를 Sentry로 모니터링하고, 에러 원인 조사·이벤트 페이로드 확인을 Claude로 바로 하고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "error-monitoring",
          "observability",
          "debugging"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add --transport http sentry https://mcp.sentry.dev/mcp",
        "env": []
      },
      "source_url": "https://github.com/getsentry/sentry-mcp",
      "popularity": "Sentry 공식 원격 서버, 널리 쓰임",
      "seo": {
        "seoTitle": "Sentry MCP Server: Claude Code로 에러·트레이스 조회 (공식 원격)",
        "metaDescription": "Sentry 공식 원격 MCP 서버를 Claude Code에 연결해 이슈·에러 리포트·트레이스·성능 데이터를 대화로 조회. 디버깅과 옵저버빌리티 워크플로를 LLM 안에서 처리하세요.",
        "summary": "Sentry MCP Server는 Sentry의 이슈, 에러 리포트, 트레이스, 성능 데이터를 Claude Code 같은 MCP 클라이언트에서 직접 조회할 수 있게 해주는 공식 원격(remote) MCP 서버입니다. Sentry를 만든 getsentry가 직접 운영하며, 별도 로컬 패키지를 설치하지 않고 HTTP 전송 방식으로 `https://mcp.sentry.dev/mcp` 엔드포인트에 연결해 사용합니다.\n\n해결하는 문제는 분명합니다. 평소 운영자는 에러가 터지면 Sentry 대시보드를 열어 이슈를 검색하고, 스택 트레이스를 읽고, 영향 범위와 발생 빈도를 확인한 뒤 다시 코드 에디터로 돌아오는 컨텍스트 전환을 반복합니다. 이 MCP 서버를 연결하면 그 흐름을 LLM 대화 안에서 처리할 수 있습니다. \"최근 가장 자주 발생한 에러가 뭐야\", \"이 이슈의 스택 트레이스 보여줘\", \"관련 트레이스에서 느린 구간 찾아줘\" 같은 자연어 요청을 통해 Sentry 데이터를 끌어와 분석하고, 곧바로 코드 수정 제안까지 이어갈 수 있습니다.\n\n핵심 기능은 Sentry 프로젝트의 이슈/에러 목록 조회, 개별 이슈의 상세·스택 트레이스 확인, 분산 트레이스와 성능(트랜잭션) 데이터 탐색, 에러 발생 추이 파악 등입니다. 구체적으로 노출되는 도구 집합과 권한 범위는 버전과 계정 설정에 따라 달라질 수 있으므로 정확한 목록은 공식 문서(getsentry/sentry-mcp) 확인을 권장합니다.\n\n쓰면 좋은 대상은 Sentry로 에러 모니터링·옵저버빌리티를 운영하는 백엔드/풀스택 개발자, 장애 대응 중 빠르게 원인을 좁혀야 하는 온콜 엔지니어, 그리고 에러 데이터를 근거로 AI에게 디버깅을 위임하고 싶은 팀입니다. 대시보드와 에디터 사이를 오가던 디버깅 루프를 단축하려는 경우 특히 유용합니다.",
        "whenToUse": "Sentry로 에러·성능을 모니터링하면서 디버깅 루프를 Claude Code 안에서 단축하고 싶을 때 적합합니다. 장애 대응 중 최근 이슈·스택 트레이스·영향 범위를 빠르게 조회하거나, 트레이스에서 느린 구간을 찾고, 에러 데이터를 근거로 AI에게 수정안을 받고 싶을 때 유용합니다. Sentry를 쓰지 않거나 단순 로컬 로그만 보는 경우엔 필요하지 않습니다.",
        "installNotes": "공식 원격(remote) 서버라 로컬 패키지 설치가 없고 HTTP 전송으로 호스팅 엔드포인트에 연결합니다. 첫 연결 시 Sentry 계정 인증(OAuth 등)이 요구되며, 접근 가능한 조직/프로젝트는 인증된 계정 권한에 따릅니다. 원격 서버 특성상 네트워크 연결이 필요하고, 노출되는 도구 집합은 버전에 따라 달라질 수 있으니 정확한 설정·권한 범위·셀프호스트 옵션 여부는 공식 문서(getsentry/sentry-mcp) 확인을 권장합니다.",
        "securityNotes": "이 서버는 인증된 Sentry 계정 권한으로 조직의 이슈·에러·트레이스·성능 데이터에 접근하므로, 스택 트레이스나 에러 메시지에 담길 수 있는 내부 경로·사용자 식별자·토큰 등 민감정보가 LLM 컨텍스트로 들어올 수 있습니다. 최소 권한 계정/토큰으로 연결하고, 불필요한 프로젝트 노출을 줄이세요. 인증 토큰은 출력·커밋 금지. 또한 에러 메시지·이벤트 본문 등 외부에서 유입된 콘텐츠가 프롬프트 인젝션 벡터가 될 수 있으므로, 모델이 그 내용을 명령으로 오인하지 않도록 주의하고 자동 실행성 동작은 검토 후 적용하세요.",
        "faq": [
          {
            "q": "Sentry MCP Server를 쓰려면 별도 패키지를 설치해야 하나요?",
            "a": "아니요. 공식 원격(remote) MCP 서버라 로컬 패키지 설치 없이 HTTP 전송으로 호스팅 엔드포인트에 연결합니다. 대신 첫 연결 시 Sentry 계정 인증이 필요합니다."
          },
          {
            "q": "어떤 데이터를 조회할 수 있나요?",
            "a": "Sentry의 이슈·에러 리포트, 스택 트레이스, 분산 트레이스와 성능 데이터 등을 조회할 수 있습니다. 노출되는 정확한 도구 목록은 버전에 따라 달라질 수 있어 공식 문서(getsentry/sentry-mcp) 확인을 권장합니다."
          },
          {
            "q": "접근 권한 범위는 어떻게 정해지나요?",
            "a": "인증한 Sentry 계정의 권한을 그대로 따릅니다. 따라서 최소 권한 계정으로 연결하고, 민감정보가 포함될 수 있는 스택 트레이스가 LLM 컨텍스트로 들어온다는 점을 고려해 노출 범위를 관리하는 것이 좋습니다."
          }
        ],
        "relatedIds": [
          "mcp-linear",
          "mcp-gitlab",
          "mcp-atlassian"
        ]
      }
    },
    {
      "id": "mcp-slack",
      "type": "mcp",
      "name": "Slack MCP Server (공식 플러그인)",
      "description": "Slack의 메시지·채널 히스토리·스레드 검색, 메시지 전송, Canvas, 사용자 프로필 조회를 제공하는 Slack 공식 MCP. 워크스페이스 관리자 승인 필요.",
      "useWhen": "팀 커뮤니케이션이 Slack 중심이고, 채널/스레드 검색이나 알림 메시지 전송을 Claude로 다루고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "messaging",
          "collaboration",
          "team-communication"
        ]
      },
      "install": {
        "method": "manual",
        "command": "공식 문서 참조: slack-mcp-plugin repo를 클론 후 `claude --plugin-dir ./`로 추가(원격 호스티드, 관리자 승인 필요)",
        "env": []
      },
      "source_url": "https://github.com/slackapi/slack-mcp-plugin",
      "popularity": "Slack 공식(slackapi) 플러그인",
      "seo": {
        "seoTitle": "Slack MCP Server (공식 플러그인) — Claude로 슬랙 메시지·검색·전송 연동",
        "metaDescription": "Slack 공식 MCP 서버. Claude Code에서 슬랙 채널·스레드·메시지 검색, 메시지 전송, Canvas, 사용자 프로필 조회를 연동한다. 워크스페이스 관리자 승인 필요.",
        "summary": "Slack MCP Server는 Slack이 공식 제공하는 MCP(Model Context Protocol) 플러그인으로, Claude Code 같은 AI 에이전트가 워크스페이스의 슬랙 데이터를 직접 조회하고 조작할 수 있게 연결해 준다. 핵심 기능은 (1) 채널·스레드의 메시지 히스토리 조회와 키워드 검색, (2) 채널이나 스레드로의 메시지 전송, (3) Canvas 문서 다루기, (4) 사용자 프로필 조회다. 이를 통해 \"어제 #배포 채널에서 논의된 내용 요약\", \"특정 스레드의 결정사항 정리 후 후속 메시지 작성\", \"담당자 프로필 확인\" 같은 작업을 사람이 슬랙을 일일이 뒤지지 않고 자연어 지시만으로 처리할 수 있다.\n\n해결하는 문제는 분명하다. 팀의 의사결정·맥락·히스토리는 대부분 슬랙에 흩어져 있는데, 이를 코드 작업이나 문서 작성으로 끌어오려면 수작업 복붙이 필요했다. 이 서버는 그 맥락을 AI 작업 흐름 안으로 직접 가져와, 슬랙 대화를 읽고 검색하고 다시 슬랙으로 결과를 회신하는 루프를 만든다.\n\n누가 쓰면 좋은가: 슬랙을 주 커뮤니케이션 도구로 쓰는 팀, 회의·논의 내용을 정리하거나 알림·요약을 자동화하려는 사람, 코드 리뷰·배포·이슈 트래킹의 맥락을 슬랙에서 끌어와 작업하는 개발자에게 적합하다.\n\n설치는 원격 호스티드 방식이며 워크스페이스 관리자 승인이 필요하다. 본 레지스트리의 설치 명령은 참고용이고, 정확한 절차·범위·인증 방식은 공식 저장소(slackapi/slack-mcp-plugin) 문서를 반드시 확인하기를 권장한다. 권한 범위와 접근 가능한 채널은 관리자가 통제하므로, 도입 전 조직 정책과 OAuth 스코프를 함께 검토하는 것이 안전하다.",
        "whenToUse": "슬랙이 팀의 주 소통 채널이고, 그 안의 대화·히스토리·결정사항을 AI 작업으로 끌어오고 싶을 때 적합하다. 예를 들어 특정 채널/스레드 요약, 논의 내용 기반 후속 메시지 작성, 알림·리포트 자동 전송, 담당자 프로필 확인 등에 쓴다. 워크스페이스 관리자 승인을 받을 수 있는 조직 환경, 그리고 접근 범위를 관리자가 통제하는 거버넌스가 가능한 팀에 권한다.",
        "installNotes": "원격 호스티드 방식이라 워크스페이스 관리자 승인이 선행되어야 하며, 개인이 임의로 붙일 수 없다. 본 항목의 설치 명령(plugin-dir로 추가)은 참고용 표기이고, 실제 설치 절차·인증 흐름·필요한 OAuth 스코프는 공식 저장소(slackapi/slack-mcp-plugin) 문서를 그대로 따르기를 권장한다. 도입 전 관리자와 함께 접근 가능한 채널 범위, 봇 권한, 데이터 정책을 확인하라. 버전·기능은 변동될 수 있으므로 공식 문서 확인이 가장 정확하다.",
        "securityNotes": "슬랙은 민감 정보가 모이는 채널이므로 권한 최소화가 핵심이다. 관리자 승인으로 부여되는 OAuth 스코프와 접근 가능한 채널을 꼭 한정하고, 비공개 채널·DM 접근이 정말 필요한지 검토하라. 메시지 전송 권한은 AI가 잘못된/스팸성 메시지를 보낼 수 있으니, 전송 동작에는 사람 확인 단계를 두는 것이 안전하다. 가장 큰 위험은 prompt injection이다 — 슬랙 메시지 본문에 심어진 지시문을 AI가 명령으로 오인해 데이터 유출·임의 전송을 수행할 수 있으므로, 외부/미신뢰 콘텐츠를 그대로 신뢰하지 말 것. 토큰·인증 비밀키는 출력·커밋 금지.",
        "faq": [
          {
            "q": "설치하려면 무엇이 필요한가요?",
            "a": "원격 호스티드 방식이라 워크스페이스 관리자 승인이 반드시 필요합니다. 개인이 임의로 연결할 수 없으며, 정확한 설치 절차와 필요한 권한 범위는 공식 저장소(slackapi/slack-mcp-plugin) 문서를 확인하세요."
          },
          {
            "q": "어떤 작업을 할 수 있나요?",
            "a": "채널·스레드의 메시지 히스토리 조회와 검색, 채널/스레드로의 메시지 전송, Canvas 문서 다루기, 사용자 프로필 조회를 제공합니다. 슬랙 맥락을 요약하거나 후속 메시지를 작성하는 흐름에 쓰기 좋습니다."
          },
          {
            "q": "보안에서 가장 주의할 점은?",
            "a": "권한 최소화와 prompt injection 방어입니다. 접근 채널·스코프를 한정하고, 메시지 전송에는 사람 확인 단계를 두며, 슬랙 본문에 심긴 지시문을 명령으로 오인하지 않도록 외부 콘텐츠를 무조건 신뢰하지 마세요."
          }
        ],
        "relatedIds": [
          "mcp-notion",
          "mcp-linear",
          "mcp-atlassian"
        ]
      }
    },
    {
      "id": "mcp-atlassian",
      "type": "mcp",
      "name": "Atlassian MCP Server (공식 원격)",
      "description": "Jira·Confluence(및 Compass/Bitbucket)를 OAuth로 읽고 쓰는 Atlassian 공식 원격 MCP 서버. 2026-02 GA, Claude가 첫 공식 파트너.",
      "useWhen": "이슈/문서를 Jira·Confluence로 관리하는 팀에서 이슈 생성·문서 조회/작성을 Claude로 자동화하고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "issue-tracking",
          "docs",
          "project-management",
          "collaboration"
        ]
      },
      "install": {
        "method": "manual",
        "command": "공식 문서 참조: `claude mcp add --transport http atlassian https://mcp.atlassian.com/v1/sse` 형태로 추가 후 OAuth 로그인(정확한 엔드포인트는 공식 문서 확인)",
        "env": []
      },
      "source_url": "https://github.com/atlassian/atlassian-mcp-server",
      "popularity": "Atlassian 공식 원격 서버, 2026-02 GA",
      "seo": {
        "seoTitle": "Atlassian MCP Server: Jira·Confluence를 Claude로 연결하는 공식 원격 MCP",
        "metaDescription": "Atlassian 공식 원격 MCP 서버 설치·활용 가이드. Claude에서 Jira 이슈와 Confluence 문서를 OAuth로 안전하게 읽고 쓰는 방법, 권한·보안 주의점, 관련 도구를 정리했습니다.",
        "summary": "Atlassian MCP Server는 Atlassian이 공식 제공하는 원격(remote) MCP 서버로, Claude 같은 AI 클라이언트가 Jira·Confluence(및 Compass·Bitbucket)의 데이터에 직접 접근해 읽고 쓸 수 있게 해 줍니다. 2026-02 GA(정식 출시)되었고, Claude가 첫 공식 파트너로 소개되었습니다. 별도 패키지를 로컬에 설치·실행하는 대신 Atlassian이 호스팅하는 원격 엔드포인트에 HTTP 전송으로 연결하고, OAuth 로그인으로 사용자 본인 계정의 권한 범위 안에서 동작하는 것이 특징입니다.\n\n해결하는 문제는 분명합니다. 그동안 AI에게 \"이 스프린트의 미해결 버그를 정리해줘\", \"이 회의록을 Confluence 페이지로 만들어줘\" 같은 일을 시키려면 사람이 Jira/Confluence를 직접 오가며 복사·붙여넣기를 해야 했습니다. 이 서버를 연결하면 Claude가 대화 안에서 Jira 이슈를 검색·조회·생성·업데이트하고, 코멘트를 달고, Confluence 문서를 찾아 읽거나 초안을 작성하는 흐름을 자연어로 처리할 수 있습니다. 이슈 트래킹, 문서화, 프로젝트 관리, 팀 협업 작업을 사람이 도구를 전환하지 않고 한 대화 안에서 이어갈 수 있게 해 주는 셈입니다.\n\n핵심 기능은 (1) Jira 이슈·프로젝트 조회 및 생성·수정 (2) Confluence 페이지 검색·읽기·작성 보조 (3) Compass·Bitbucket 등 Atlassian 제품 연계 (4) OAuth 기반의 사용자 권한 범위 준수입니다. 공식 원격 서버이므로 로컬 토큰을 직접 다루기보다 OAuth 인증 흐름을 따르며, 노출되는 도구·권한 범위와 정확한 접속 엔드포인트는 시간이 지나며 바뀔 수 있으니 항상 Atlassian 공식 문서 확인을 권장합니다.\n\n추천 대상은 Jira·Confluence를 일상적으로 쓰는 개발팀·PM·테크라이터, 그리고 이슈 정리·릴리스 노트 초안·회의록 문서화 같은 반복 작업을 AI에게 위임하고 싶은 팀입니다. 반대로 Atlassian 제품을 쓰지 않는 환경에서는 가치가 거의 없습니다.",
        "whenToUse": "Jira로 이슈를 추적하고 Confluence로 문서를 관리하는 팀에서, Claude에게 이슈 조회·생성·업데이트나 문서 검색·초안 작성을 맡기고 싶을 때 적합합니다. 스프린트 현황 정리, 릴리스 노트 초안, 회의록의 Confluence 페이지화, 버그 리포트 생성 같은 반복 작업을 도구 전환 없이 대화로 처리할 때 유용합니다. Atlassian 제품을 쓰지 않는다면 불필요합니다.",
        "installNotes": "로컬 패키지 설치가 아니라 Atlassian이 호스팅하는 원격 MCP 서버에 HTTP 전송으로 연결하는 방식입니다. 추가 후에는 브라우저에서 OAuth 로그인으로 본인 Atlassian 계정을 인증해야 하며, 접근 범위는 그 계정의 권한을 따릅니다. 정확한 접속 엔드포인트·전송 방식·지원 제품 범위는 GA 이후에도 변경될 수 있으므로 반드시 Atlassian 공식 문서로 최신 값을 확인하세요. 조직 SSO·관리자 승인 정책에 따라 연결이 제한될 수 있습니다.",
        "securityNotes": "OAuth로 사용자 본인 계정에 연결되므로, Claude가 그 계정 권한 범위 안에서 Jira 이슈·Confluence 문서를 읽고 쓸 수 있습니다(별도 API 비밀키를 직접 넣지 않음). 쓰기·수정·삭제 권한이 부여되면 이슈/문서 변경이 실제로 반영될 수 있으니 자동 실행 전 확인 단계를 두는 것이 안전합니다. Jira/Confluence에는 외부에서 작성된 이슈·코멘트·페이지가 섞여 있어, 그 내용에 숨은 지시(프롬프트 인젝션)가 들어 있을 수 있습니다. 가져온 본문을 신뢰된 명령으로 취급하지 말고, 민감 프로젝트 접근은 최소 권한 계정으로 제한하세요. 조직 정책·관리자 승인 범위도 함께 점검할 것을 권장합니다.",
        "faq": [
          {
            "q": "Atlassian MCP Server는 직접 설치하나요, 원격인가요?",
            "a": "Atlassian이 호스팅하는 공식 원격(remote) 서버입니다. 로컬에 패키지를 깔아 실행하는 대신 HTTP 전송으로 원격 엔드포인트에 연결하고 OAuth로 로그인합니다. 정확한 엔드포인트는 공식 문서 확인을 권장합니다."
          },
          {
            "q": "어떤 Atlassian 제품을 지원하나요?",
            "a": "Jira와 Confluence가 중심이며, Compass·Bitbucket 등도 연계 대상으로 소개되었습니다. 지원 범위와 노출 도구는 변경될 수 있으니 최신 정보는 Atlassian 공식 문서에서 확인하세요."
          },
          {
            "q": "AI가 이슈나 문서를 실제로 수정할 수 있나요?",
            "a": "OAuth로 연결된 계정의 권한 범위 안에서 읽기뿐 아니라 생성·수정도 가능합니다. 실수로 변경이 반영되지 않도록 쓰기 작업은 확인 단계를 두고, 최소 권한 계정 사용을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-linear",
          "mcp-notion",
          "mcp-gitlab"
        ]
      }
    },
    {
      "id": "mcp-asana",
      "type": "mcp",
      "name": "Asana MCP Server (공식 V2 원격)",
      "description": "Asana 워크스페이스의 태스크·프로젝트·목표를 다루는 공식 V2 원격 MCP 서버. OAuth 2.0 인증(V1은 2026-05-11 종료 예정).",
      "useWhen": "프로젝트/태스크 관리를 Asana로 하고, 태스크 생성·조회·진행 추적을 Claude로 자동화하고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "task-management",
          "project-management",
          "collaboration"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 asana https://mcp.asana.com/v2/mcp",
        "env": [
          "ASANA_OAUTH_CLIENT_ID",
          "ASANA_OAUTH_CLIENT_SECRET"
        ],
        "secrets": [
          "ASANA_OAUTH_CLIENT_ID",
          "ASANA_OAUTH_CLIENT_SECRET"
        ]
      },
      "source_url": "https://developers.asana.com/docs/using-asanas-mcp-server",
      "popularity": "Asana 공식 V2 호스티드 서버",
      "seo": {
        "seoTitle": "Asana MCP Server(공식 V2 원격) — Claude로 태스크·프로젝트 관리",
        "metaDescription": "Asana 공식 V2 원격 MCP 서버 소개. OAuth 2.0으로 워크스페이스의 태스크·프로젝트·목표를 Claude Code에서 다루는 방법과 권한·보안 주의점, 활용 시나리오를 정리했습니다.",
        "summary": "Asana MCP Server(공식 V2 원격)는 프로젝트·작업 관리 도구 Asana가 직접 제공하는 원격 MCP(Model Context Protocol) 서버입니다. Claude Code 같은 MCP 클라이언트가 이 서버에 연결하면, 자연어 지시만으로 Asana 워크스페이스의 태스크·프로젝트·목표(goal)를 조회하고 다룰 수 있습니다. 서버 엔드포인트는 `https://mcp.asana.com/v2/mcp`이며 HTTP 트랜스포트와 OAuth 2.0 인증을 사용합니다. (V1 서버는 2026-05-11 종료 예정이므로 신규 연동은 V2로 진행하는 것을 권장합니다.)\n\n해결하는 문제는 분명합니다. 업무 현황을 확인하거나 새 태스크를 만들고 담당자·마감일을 정리하려고 Asana 웹/앱을 매번 오가는 컨텍스트 전환 비용을, AI 에이전트가 대신 처리하도록 줄여줍니다. 예를 들어 \"이번 주 마감인 내 태스크 보여줘\", \"이 프로젝트에 신규 태스크를 만들고 OOO에게 배정해줘\", \"분기 목표 진행 상황을 요약해줘\"처럼 대화로 요청하면, 에이전트가 MCP 도구를 호출해 Asana 데이터를 가져오거나 변경합니다.\n\n핵심 기능은 (1) 태스크 조회·생성·업데이트, (2) 프로젝트 단위 작업 정리, (3) 목표(goal) 추적, (4) 워크스페이스 컨텍스트 기반 검색·요약 등 협업 워크플로 자동화입니다. 공식 서버이므로 인증·권한이 Asana 계정 체계와 일관되게 동작하며, 제공되는 정확한 도구 목록과 스코프는 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다.\n\n누가 쓰면 좋은가: Asana로 업무를 관리하면서 Claude 같은 AI 에이전트로 보고서 작성·진행상황 요약·반복적인 태스크 입력을 자동화하려는 팀, PM, 개발·운영 담당자에게 적합합니다. 출처: 공식 문서 https://developers.asana.com/docs/using-asanas-mcp-server",
        "whenToUse": "Asana를 팀 업무 관리에 쓰면서, Claude Code 등 AI 에이전트로 태스크 조회·생성·배정, 프로젝트/목표 진행상황 요약, 반복적인 작업 입력을 자동화하고 싶을 때 적합합니다. 업무 현황을 묻거나 보고서를 만들 때 Asana 웹/앱을 오가는 컨텍스트 전환을 줄이려는 경우에 특히 유용합니다. 단, V1은 2026-05-11 종료 예정이므로 신규 연동은 V2 원격 서버로 진행하세요.",
        "installNotes": "원격 HTTP 트랜스포트 + OAuth 2.0 인증을 사용하는 공식 V2 서버(`https://mcp.asana.com/v2/mcp`)입니다. 연결하려면 Asana 개발자 콘솔에서 OAuth 앱을 등록해 클라이언트 ID/시크릿을 발급받아야 하며, OAuth 콜백 처리를 위한 로컬 콜백 포트(예: 8080)가 필요합니다. V1 서버는 2026-05-11 종료 예정이므로 V2로 연동하세요. 제공 도구·인증 스코프·콜백 설정 세부는 버전에 따라 달라질 수 있으니 공식 문서를 확인하는 것을 권장합니다.",
        "securityNotes": "OAuth 자격증명(ASANA_OAUTH_CLIENT_ID, ASANA_OAUTH_CLIENT_SECRET)은 비밀키이므로 커밋·로그·공유를 금지하고 환경변수/시크릿 매니저로만 관리하세요. 이 서버는 Asana 워크스페이스의 태스크·프로젝트·목표 등 업무 데이터에 접근하며, 권한 범위에 따라 태스크 생성·수정·삭제 같은 쓰기 작업도 가능하므로 에이전트가 의도치 않게 데이터를 변경/삭제하지 않도록 권한을 최소 스코프로 제한하고 변경성 작업은 확인 후 실행하는 것이 안전합니다. 또한 태스크 제목·설명 등 외부에서 입력된 콘텐츠가 프롬프트 인젝션 경로가 될 수 있으므로, 가져온 내용을 그대로 신뢰해 자동 실행하지 말고 검토하세요.",
        "faq": [
          {
            "q": "Asana MCP Server V1과 V2의 차이는 무엇인가요?",
            "a": "V2는 공식 원격 MCP 서버(https://mcp.asana.com/v2/mcp)로 OAuth 2.0 인증을 사용합니다. V1은 2026-05-11 종료 예정이므로 신규 연동은 V2로 진행하는 것이 권장됩니다. 구체적인 기능 차이는 공식 문서 확인을 권장합니다."
          },
          {
            "q": "연결하려면 무엇이 필요한가요?",
            "a": "Asana 개발자 콘솔에서 OAuth 앱을 등록해 클라이언트 ID/시크릿을 발급받고, OAuth 인증을 처리할 로컬 콜백 포트가 필요합니다. 인증 후 Claude 같은 MCP 클라이언트에서 워크스페이스 데이터를 다룰 수 있습니다."
          },
          {
            "q": "AI가 태스크를 삭제하거나 잘못 변경할 위험은 없나요?",
            "a": "권한 스코프에 따라 쓰기·변경 작업이 가능하므로 위험이 있습니다. 최소 권한으로 제한하고, 생성·수정·삭제 같은 변경성 작업은 자동 실행 대신 확인 후 진행하는 것을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-linear",
          "mcp-notion",
          "mcp-atlassian"
        ]
      }
    },
    {
      "id": "mcp-stripe",
      "type": "mcp",
      "name": "Stripe MCP Server (공식 Agent Toolkit)",
      "description": "Stripe의 고객·결제·구독·환불·인보이스·청구를 다루는 Stripe 공식 MCP. 로컬 npx 또는 원격(mcp.stripe.com OAuth)으로 사용.",
      "useWhen": "결제/구독을 Stripe로 운영하고, 고객·결제·인보이스 조회나 생성을 Claude로 다루고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "payments",
          "billing",
          "saas-ops"
        ]
      },
      "install": {
        "method": "npx",
        "command": "claude mcp add stripe -- npx -y @stripe/mcp --tools=all --api-key=STRIPE_SECRET_KEY",
        "env": [
          "STRIPE_SECRET_KEY"
        ],
        "secrets": [
          "STRIPE_SECRET_KEY"
        ]
      },
      "source_url": "https://github.com/stripe/ai",
      "popularity": "Stripe 공식 agent toolkit, 널리 쓰임",
      "seo": {
        "seoTitle": "Stripe MCP Server: Claude로 결제·구독·환불 다루는 공식 MCP",
        "metaDescription": "Stripe 공식 MCP(Agent Toolkit). Claude Code에서 고객·결제·구독·환불·인보이스·청구를 자연어로 조회·조작. 로컬 npx 또는 mcp.stripe.com OAuth 원격 사용, 제한키(RAK) 권장.",
        "summary": "Stripe MCP Server는 Stripe가 공식 제공하는 Agent Toolkit의 일부로, Claude Code 같은 MCP 클라이언트가 Stripe의 결제 인프라를 자연어로 다룰 수 있게 해주는 서버입니다. Stripe의 공식 Node/Python SDK 위에 구축되어 있어, 모델이 직접 REST API 호출 코드를 작성하지 않고도 함수 호출(tool) 형태로 Stripe 리소스를 조회·생성·변경할 수 있습니다.\n\n다루는 주요 영역은 고객(customers), 결제(payments), 구독(subscriptions), 환불(refunds), 인보이스(invoices), 청구(billing)입니다. 예를 들어 \"이 고객의 최근 결제 내역 보여줘\", \"구독 플랜 만들어줘\", \"이 결제 환불해줘\", \"미발행 인보이스 정리해줘\" 같은 요청을 대화로 처리할 수 있습니다. 노출되는 정확한 메서드 목록과 범위는 Stripe MCP 공식 문서에서 확인하는 것을 권장합니다.\n\n사용 방식은 두 가지입니다. (1) 로컬 실행: `@stripe/mcp` 패키지를 npx로 띄우고 `--tools=all`로 도구 범위를 지정하며 `--api-key`로 인증합니다. (2) 원격 실행: Stripe가 운영하는 `https://mcp.stripe.com`에 OAuth로 연결해 로컬에 키를 두지 않고 사용할 수 있습니다.\n\n누가 쓰면 좋은가: SaaS·구독 서비스를 운영하며 결제·정산 운영(billing ops)을 자동화하거나, 고객 지원 중 환불·구독 조정을 빠르게 처리하거나, 통합 개발 단계에서 테스트 데이터를 만들고 점검하려는 팀에 유용합니다. 다만 결제는 실제 금전이 오가는 민감 영역이므로, 운영(live) 환경에서는 권한을 좁힌 제한키와 테스트 모드 우선 검증을 강하게 권장합니다. (정확한 도구·요금·정책은 Stripe 공식 문서 확인 권장.)",
        "whenToUse": "SaaS·구독 제품의 결제/정산 운영을 Claude로 자동화하거나, 고객 지원 중 환불·구독 변경을 대화로 빠르게 처리할 때. Stripe 통합 개발 단계에서 테스트 모드로 고객·인보이스·구독 더미 데이터를 만들고 상태를 점검할 때도 적합합니다. 반대로 실거래 운영(live)에서 자동화된 환불·구독 취소를 모델에 맡기는 건 금전 위험이 있으니 신중해야 합니다.",
        "installNotes": "로컬 실행은 Node 18+ 환경이 필요하며 npx로 `@stripe/mcp`를 받아 띄웁니다. `--tools=all`은 모든 도구를 노출하므로 운영에선 필요한 범위로 좁히는 편이 안전합니다. 키를 로컬에 두기 싫으면 `https://mcp.stripe.com` OAuth 원격 연결을 쓰면 됩니다. 인증은 처음엔 테스트 키로 검증한 뒤 운영으로 넘기고, 실제 노출 메서드 목록·옵션은 Stripe MCP 공식 문서 확인을 권장합니다.",
        "securityNotes": "STRIPE_SECRET_KEY는 결제 계정 전체를 조작할 수 있는 최상위 비밀키이므로 절대 커밋·로그·출력 금지(.env로만 관리). 시크릿 키(sk_) 대신 권한을 좁힌 제한키(RAK, rk_*) 사용을 강력 권장하며, 노출되는 도구는 제한키 권한 범위로 제한됩니다. 환불·구독 취소·고객 삭제 등 비가역·금전 작업이 모델 명령으로 실행될 수 있으니 운영 키 사용 시 사람 승인 게이트를 두고, 외부 콘텐츠(고객 메모·인보이스 설명 등)에 섞인 프롬프트 인젝션이 결제 조작을 유도할 위험을 경계하세요. 우선 테스트 모드로 검증.",
        "faq": [
          {
            "q": "로컬 npx 방식과 원격(mcp.stripe.com) 방식 중 뭘 써야 하나요?",
            "a": "로컬에 비밀키를 두기 싫거나 OAuth 기반 접근을 원하면 mcp.stripe.com 원격을 쓰고, 자체 환경에서 키와 도구 범위를 직접 통제하고 싶으면 npx 로컬 실행을 쓰면 됩니다. 둘 다 Stripe 공식 경로입니다."
          },
          {
            "q": "실수로 실제 결제가 환불되거나 구독이 취소될 위험은 없나요?",
            "a": "있습니다. 모델 명령으로 환불·취소 같은 비가역 작업이 실행될 수 있으므로, 운영(live)에서는 권한을 좁힌 제한키(RAK) + 사람 승인을 두고 먼저 테스트 모드 키로 검증하는 것을 권장합니다."
          },
          {
            "q": "어떤 도구(메서드)가 정확히 노출되나요?",
            "a": "고객·결제·구독·환불·인보이스·청구 영역을 다루며, 노출되는 도구는 사용한 제한키의 권한 범위에 따라 달라집니다. 전체 메서드 목록은 Stripe MCP 공식 문서 확인을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-supabase",
          "mcp-sentry",
          "mcp-linear"
        ]
      }
    },
    {
      "id": "mcp-gitlab",
      "type": "mcp",
      "name": "GitLab MCP Server (공식 GitLab Duo)",
      "description": "GitLab의 이슈·MR·프로젝트 등을 다루는 GitLab 공식 원격 MCP 서버(GitLab Duo). 활성 GitLab Duo 구독 필요.",
      "useWhen": "코드 호스팅/CI를 GitLab으로 운영하고 이슈·MR 작업을 Claude로 다루고 싶을 때(GitLab Duo 구독 보유 시).",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "git",
          "issue-tracking",
          "devops",
          "collaboration"
        ]
      },
      "install": {
        "method": "manual",
        "command": "공식 문서 참조: GitLab Duo 원격 MCP 엔드포인트(`https://gitlab.com/api/v4/orbit/mcp`)를 streamable-http transport로 추가(구독·인증 절차는 공식 문서 확인)",
        "env": []
      },
      "source_url": "https://docs.gitlab.com/orbit/remote/access/mcp/",
      "popularity": "GitLab 공식(GitLab Duo) 원격 서버",
      "seo": {
        "seoTitle": "GitLab MCP Server (GitLab Duo) — Claude Code 원격 MCP 연동 가이드",
        "metaDescription": "GitLab 공식 원격 MCP 서버(GitLab Duo/Orbit)를 Claude Code에 연결해 이슈·MR·프로젝트 지식 그래프를 자연어로 조회하는 방법. 구독·인증·보안 주의점 정리.",
        "summary": "GitLab MCP Server는 GitLab이 공식 제공하는 원격 MCP(Model Context Protocol) 서버로, GitLab Duo 계열의 Orbit 엔드포인트(`https://gitlab.com/api/v4/orbit/mcp`)를 통해 AI 에이전트가 GitLab의 프로젝트·이슈·머지 리퀘스트(MR) 등 지식 그래프를 질의할 수 있게 해준다. Claude Code 같은 MCP 호환 클라이언트에 streamable-http(네이티브 HTTP) transport로 추가하면, 사람이 GitLab UI를 직접 뒤지지 않아도 자연어로 \"이 프로젝트의 열린 MR\", \"특정 파일 변경의 영향 범위(blast radius)\", \"의존성 맵\" 같은 질문을 던지고 타입이 있는 결과를 받아볼 수 있다.\n\n해결하는 문제는 명확하다. 코드 작업과 협업 맥락이 GitLab에 흩어져 있을 때, 에이전트가 그 맥락을 직접 끌어와 작업에 반영하기 어렵다는 점이다. 이 서버는 GitLab을 에이전트가 읽을 수 있는 데이터 소스로 만들어, 이슈 추적·MR 리뷰 준비·프로젝트 분석·의존성/영향도 파악 같은 DevOps 협업 흐름을 대화형으로 끌어올린다.\n\n공식 문서 기준 핵심 도구는 두 가지다. `get_graph_schema`(노드 타입·속성·관계 타입 등 현재 스키마 조회)와 `query_graph`(Orbit 쿼리 DSL로 그래프를 질의해 타입 결과 반환)다. 즉 임의의 쓰기·삭제 API라기보다, GitLab 지식 그래프를 읽고 질의하는 데 초점이 맞춰진 형태다. (세부 capability와 tier 정책은 베타 단계에서 바뀔 수 있으므로 공식 문서 확인 권장.)\n\n쓰면 좋은 대상: GitLab.com에서 Premium/Ultimate 등 활성 구독을 보유하고, 이슈·MR이 많아 맥락 파악 비용이 큰 팀, 그리고 Claude Code 등 에이전트로 코드 리뷰·DevOps 작업을 자동화하려는 개발자다. 설치는 수동(manual)으로 위 엔드포인트를 HTTP transport로 등록하는 방식이며, 구독·인증 절차는 반드시 공식 문서를 따른다.",
        "whenToUse": "GitLab.com에 이슈·MR·프로젝트가 누적돼 있고, 에이전트(Claude Code 등)가 그 맥락을 직접 끌어와 코드 리뷰·DevOps 작업에 반영하길 원할 때 적합하다. 영향 범위 분석, 의존성 맵, MR 추적처럼 GitLab 데이터를 자연어로 질의하고 싶을 때 유용하다. 단 활성 GitLab Duo(Premium/Ultimate) 구독과 GitLab.com 환경이 전제이며, 셀프호스트/무료 tier 위주거나 단순 git 푸시만 필요하면 굳이 필요 없다.",
        "installNotes": "원격 MCP 서버라 별도 패키지 설치 없이 엔드포인트 등록만으로 동작한다. Claude Code에는 네이티브 HTTP(streamable-http) transport로 `https://gitlab.com/api/v4/orbit/mcp`를 추가하며, 일부 클라이언트는 `mcp-remote`로 stdio 래핑이 필요할 수 있다. GitLab.com Premium/Ultimate 활성 구독과 OAuth(기본) 또는 read_api 스코프의 PAT가 필요하고, 네이티브 HTTP는 mcp_orbit OAuth 스코프를 명시 요청해야 한다. 베타 기능이므로 정확한 구독·인증·스코프 절차는 공식 문서 확인을 권장한다.",
        "securityNotes": "이 서버는 GitLab 계정 권한으로 비공개 프로젝트·이슈·MR·코드 메타데이터에 접근하므로, 인증 토큰 노출은 곧 조직 소스 접근 노출이다. PAT 사용 시 최소 권한 원칙으로 read_api 스코프만 부여하고 토큰을 코드/로그에 출력하거나 커밋하지 말 것(가급적 OAuth 권장). 질의가 GitLab Credits 같은 사용량/과금을 소비할 수 있어 자동화 시 비용 폭주에 유의한다. 또한 이슈·MR 본문 등 외부에서 작성된 콘텐츠가 모델에 유입되므로 프롬프트 인젝션 위험이 있다 — 신뢰 경계 밖 텍스트를 명령으로 취급하지 않도록 주의하고, 도구 권한과 자동 실행 범위를 보수적으로 설정한다.",
        "faq": [
          {
            "q": "GitLab Duo 구독 없이도 쓸 수 있나요?",
            "a": "공식 문서 기준 GitLab.com Premium/Ultimate(GitLab Duo 계열) 활성 구독이 전제입니다. 무료 tier나 셀프호스트 환경에서의 지원 여부는 베타 정책에 따라 다를 수 있으니 공식 문서 확인을 권장합니다."
          },
          {
            "q": "이 서버로 이슈를 생성하거나 MR을 머지할 수 있나요?",
            "a": "공식 문서가 노출하는 핵심 도구는 지식 그래프 스키마 조회(get_graph_schema)와 질의(query_graph) 중심으로, 읽기·분석에 초점이 있습니다. 쓰기/파괴적 작업 가능 여부는 명시되지 않았으므로 공식 문서 확인을 권장합니다."
          },
          {
            "q": "Claude Code에는 어떻게 연결하나요?",
            "a": "원격 엔드포인트 https://gitlab.com/api/v4/orbit/mcp 를 streamable-http(네이티브 HTTP) transport로 등록합니다. OAuth(기본) 또는 read_api 스코프 PAT로 인증하며, 네이티브 HTTP는 mcp_orbit 스코프 명시가 필요합니다."
          }
        ],
        "relatedIds": [
          "mcp-atlassian",
          "mcp-linear",
          "mcp-sentry"
        ]
      }
    },
    {
      "id": "mcp-firecrawl",
      "type": "mcp",
      "name": "Firecrawl MCP",
      "description": "웹페이지를 LLM이 읽기 좋은 마크다운으로 스크래핑하고, 사이트 크롤링·구조화 추출·웹 검색을 제공하는 공식 Firecrawl MCP 서버.",
      "useWhen": "블로그/문서 사이트를 통째로 긁어 마크다운으로 가져오거나, 동적 페이지를 안정적으로 스크래핑·구조화 추출하고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [
          "node"
        ],
        "task": [
          "web-scraping",
          "crawling",
          "web-search",
          "data-extraction"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add firecrawl -- npx -y firecrawl-mcp",
        "env": [
          "FIRECRAWL_API_KEY"
        ],
        "secrets": [
          "FIRECRAWL_API_KEY"
        ]
      },
      "source_url": "https://github.com/firecrawl/firecrawl-mcp-server",
      "popularity": "공식 Firecrawl 서버. npm firecrawl-mcp로 널리 사용, MCP 생태계에서 대표적 스크래핑 서버로 자주 언급됨.",
      "seo": {
        "seoTitle": "Firecrawl MCP — Claude Code 웹 스크래핑·크롤링·검색 MCP 서버",
        "metaDescription": "웹페이지를 LLM이 읽기 좋은 마크다운으로 스크래핑하고 사이트 크롤링·구조화 추출·웹 검색까지 제공하는 공식 Firecrawl MCP 서버. Claude Code 설치·API 키·보안 주의점 정리.",
        "summary": "Firecrawl MCP는 Claude 같은 AI 에이전트가 웹을 직접 읽고 활용하도록 해주는 공식 Firecrawl MCP(Model Context Protocol) 서버입니다. 핵심은 임의의 웹페이지를 광고·내비게이션 같은 잡음을 걷어내고 LLM이 처리하기 좋은 깔끔한 마크다운(또는 구조화된 JSON)으로 변환하는 것입니다. 단일 페이지 스크래핑은 물론, 여러 URL을 한 번에 처리하는 배치 스크래핑, 사이트의 인덱싱된 URL을 훑는 맵(map), 연관된 다수 페이지를 비동기로 수집하는 크롤(crawl)을 제공합니다.\n\n또한 웹 검색(search)으로 질의 결과를 가져와 그 자리에서 본문을 추출할 수 있고, 추출(extract)은 LLM 기반으로 페이지에서 원하는 필드를 구조화된 데이터로 뽑아냅니다. 그 외에 복잡한 다중 소스 조사를 자동으로 수행하는 에이전트, 페이지 안에서 클릭·이동 등 상호작용, 예약 점검·웹훅으로 변경을 추적하는 모니터링 등 폭넓은 도구를 노출합니다(도구 구성은 버전에 따라 달라질 수 있어 공식 문서 확인을 권장합니다).\n\n해결하는 문제는 분명합니다. AI는 학습 시점 이후의 정보나 비공개·동적 페이지를 알지 못하는데, Firecrawl MCP를 붙이면 \"이 URL 내용 요약해줘\", \"이 사이트의 가격표를 표로 뽑아줘\", \"최신 문서 찾아 근거와 함께 정리해줘\" 같은 작업을 에이전트가 실제 웹 데이터로 처리할 수 있습니다.\n\n추천 대상: 경쟁사·문서·뉴스를 정기적으로 수집하는 리서치/그로스 담당자, RAG 파이프라인에 신선한 웹 데이터를 넣으려는 개발자, 코드 작성 중 외부 레퍼런스를 그때그때 끌어와야 하는 사람입니다. 클라우드 API와 셀프호스팅(FIRECRAWL_API_URL) 두 방식을 모두 지원합니다.",
        "whenToUse": "최신·동적·비공개가 아닌 웹 콘텐츠를 AI가 직접 읽어야 할 때 적합합니다. 단일 페이지 요약, 사이트 전체 크롤링, 가격·스펙 같은 구조화 데이터 추출, 키워드 웹 검색 후 근거 수집, RAG용 신선한 코퍼스 확보, 경쟁사·문서 모니터링 등에 유용합니다. 코딩 중 외부 레퍼런스를 그때그때 가져오는 용도로도 좋습니다. 반대로, 로그인 뒤의 민감 데이터나 약관상 수집이 금지된 사이트에는 쓰지 마세요.",
        "installNotes": "클라우드 사용 시 firecrawl.dev에서 발급한 FIRECRAWL_API_KEY 환경변수가 필요합니다. 셀프호스팅은 키 대신 FIRECRAWL_API_URL로 자체 인스턴스를 가리킬 수 있습니다. Node 런타임(npx) 기반이라 Node.js 설치가 전제입니다. 크레딧 기반 과금이라 경고/위험 임계값(기본 1000/100 크레딧)과 검색 비용(쿼리당 2크레딧 등)을 미리 확인하고, 자동 재시도·레이트리밋 설정도 점검하세요. 도구 구성은 버전마다 다르므로 공식 문서 확인을 권장합니다.",
        "securityNotes": "FIRECRAWL_API_KEY는 결제와 직결되는 비밀키입니다. 코드·로그·커밋에 노출하지 말고 환경변수/시크릿 저장소로만 주입하세요. 키 유출 시 무단 사용으로 크레딧이 소진돼 직접 과금 피해가 발생할 수 있고, 크롤·배치는 대량 호출로 비용이 급증할 수 있으니 한도·임계값을 설정하세요. 가장 큰 위험은 프롬프트 인젝션입니다. 스크래핑한 외부 페이지에 \"이전 지시를 무시하라\" 같은 악성 지시가 숨어 에이전트를 조종할 수 있으므로, 가져온 콘텐츠는 신뢰 불가 입력으로 취급하고 자동 실행·민감 작업과 분리하세요. robots.txt와 사이트 약관, 개인정보·저작권 준수도 필수입니다.",
        "faq": [
          {
            "q": "FIRECRAWL_API_KEY 없이도 쓸 수 있나요?",
            "a": "클라우드 API를 쓰려면 firecrawl.dev에서 발급한 키가 필요합니다. 다만 셀프호스팅으로 직접 인스턴스를 운영하면 키 대신 FIRECRAWL_API_URL로 자체 서버를 가리켜 사용할 수 있습니다. 정확한 인증 옵션은 공식 문서 확인을 권장합니다."
          },
          {
            "q": "로그인이 필요한 비공개 페이지도 가져올 수 있나요?",
            "a": "기본 용도는 공개된 정적·동적 웹 콘텐츠 수집입니다. 인증 뒤의 민감 데이터나 약관상 수집이 금지된 페이지는 권장하지 않으며, robots.txt와 사이트 이용약관, 저작권·개인정보 규정을 반드시 준수해야 합니다."
          },
          {
            "q": "크롤이나 검색을 많이 하면 비용이 많이 드나요?",
            "a": "크레딧 기반 과금이라 크롤·배치·검색 호출이 많을수록 크레딧이 소모됩니다. 검색은 쿼리당 일정 크레딧이 들고 경고/위험 임계값(기본 1000/100)이 있으니, 한도와 자동 레이트리밋을 미리 설정해 비용 폭주를 막는 것이 좋습니다."
          }
        ],
        "relatedIds": [
          "mcp-tavily",
          "mcp-exa",
          "mcp-brightdata"
        ]
      }
    },
    {
      "id": "mcp-tavily",
      "type": "mcp",
      "name": "Tavily MCP",
      "description": "실시간 웹 검색·콘텐츠 추출·사이트 맵/크롤을 제공하는 공식 Tavily MCP 서버. LLM 친화적 검색 결과에 특화.",
      "useWhen": "최신 정보 기반 웹 검색과 검색 결과 본문 추출을 한 번에 처리하고 싶을 때(리서치 자동화 등).",
      "tags": {
        "framework": [],
        "lang": [
          "node"
        ],
        "task": [
          "web-search",
          "data-extraction",
          "crawling",
          "research"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add --transport http tavily \"https://mcp.tavily.com/mcp/?tavilyApiKey=<TAVILY_API_KEY>\"",
        "env": [
          "TAVILY_API_KEY"
        ],
        "secrets": [
          "TAVILY_API_KEY"
        ]
      },
      "source_url": "https://github.com/tavily-ai/tavily-mcp",
      "popularity": "공식 Tavily 서버. 원격 호스팅 URL 제공, 리서치/검색 MCP로 널리 사용됨.",
      "seo": {
        "seoTitle": "Tavily MCP 서버 — Claude Code 실시간 웹 검색·콘텐츠 추출·크롤링",
        "metaDescription": "Tavily MCP는 Claude Code에 실시간 웹 검색, 콘텐츠 추출, 사이트 맵·크롤 기능을 붙이는 공식 서버입니다. LLM 친화적 검색 결과로 리서치를 자동화하세요.",
        "summary": "Tavily MCP는 Tavily에서 공식 제공하는 MCP(Model Context Protocol) 서버로, Claude Code 같은 LLM 에이전트에 실시간 웹 검색과 웹 콘텐츠 처리 능력을 붙여 줍니다. Tavily는 LLM·AI 에이전트의 리서치 용도로 설계된 검색 API로, 일반 검색엔진의 원시 결과 대신 모델이 바로 활용하기 좋은 형태로 정제된 결과를 돌려주는 데 특화돼 있습니다. 이를 MCP로 연결하면, 모델이 학습 시점 이후의 최신 정보나 사이트의 실제 내용을 도구 호출로 직접 가져와 답변에 반영할 수 있습니다.\n\n주요 기능은 크게 네 가지입니다. (1) 웹 검색: 자연어 질의로 관련 출처를 찾고 LLM이 소화하기 쉬운 형태로 결과를 받습니다. (2) 콘텐츠 추출(extraction): 특정 URL의 본문 텍스트를 깔끔하게 추출해 노이즈를 줄입니다. (3) 사이트 맵/크롤링: 사이트 구조를 파악하거나 여러 페이지를 순회해 자료를 모읍니다. (4) 리서치 워크플로 지원: 검색→추출→정리로 이어지는 조사 작업을 도구 호출 단위로 자동화합니다.\n\n이런 점에서 다음과 같은 사용자에게 유용합니다. 최신 사실 확인이나 출처 기반 답변이 필요한 사람, 경쟁/시장 조사처럼 여러 페이지를 모아 정리해야 하는 사람, 문서·기사 본문을 추출해 요약·분석하려는 사람, 에이전트형 워크플로에 \"웹을 읽는\" 능력을 더하려는 개발자입니다. 설치는 HTTP 트랜스포트 기반 원격 서버로 등록하며 Tavily API 키가 필요합니다. 구체적 도구 이름·매개변수·요금/사용량 정책은 버전에 따라 달라질 수 있으니 공식 문서(github.com/tavily-ai/tavily-mcp) 확인을 권장합니다.",
        "whenToUse": "모델이 학습 데이터에 없는 최신 정보를 가져와야 하거나, 출처 기반·사실 확인이 중요한 답변을 만들 때 적합합니다. 특정 URL의 본문을 추출해 요약·분석하거나, 사이트 여러 페이지를 크롤해 자료를 모으는 리서치 작업, 시장·경쟁 조사, 문서 수집 자동화에도 잘 맞습니다. 반대로 단발성·오프라인 작업이나 웹 접근이 불필요한 코드 작업에는 굳이 붙일 필요가 없습니다.",
        "installNotes": "HTTP 트랜스포트 기반 원격 MCP 서버로 등록하며, 동작에 Tavily API 키(TAVILY_API_KEY)가 필요합니다. 키는 Tavily 계정에서 발급받아야 하고, 무료/유료 등급별 사용량·기능 제한이 적용될 수 있으니 등록 전 본인 요금제와 한도를 확인하세요. URL 쿼리스트링에 키가 포함되는 형태이므로 키 노출에 주의해야 합니다. 제공되는 도구 이름·옵션은 버전에 따라 달라질 수 있어 공식 저장소 문서로 최신 사양 확인을 권장합니다.",
        "securityNotes": "동작에 Tavily API 키(TAVILY_API_KEY)가 필요하며, 설치 명령에서 키가 URL 쿼리스트링에 들어가므로 셸 히스토리·로그·설정 파일·화면 공유로 유출되기 쉽습니다. 키는 비밀로 관리하고 커밋·출력 금지, 유출 시 즉시 회전하세요. 검색·추출은 외부 API로 질의가 전송되므로 사내 비밀·개인정보가 검색어로 새어 나가지 않게 주의해야 합니다. 또한 가져온 웹 본문에 프롬프트 인젝션(악성 지시문)이 섞여 있을 수 있으니, 추출 결과를 신뢰된 명령으로 다루지 말고 데이터로만 취급하세요. 사용량 기반 과금 가능성도 점검이 필요합니다.",
        "faq": [
          {
            "q": "Tavily MCP를 쓰려면 별도 API 키가 필요한가요?",
            "a": "네. Tavily 계정에서 발급한 TAVILY_API_KEY가 필요하며, 이 키로 검색·추출·크롤 요청이 인증됩니다. 등급별 사용량 한도와 과금 정책이 있을 수 있으니 본인 요금제를 확인하세요."
          },
          {
            "q": "일반 웹 검색과 무엇이 다른가요?",
            "a": "Tavily는 LLM·AI 에이전트의 리서치 용도로 설계돼, 원시 검색 결과 대신 모델이 바로 활용하기 좋게 정제된 결과를 돌려주는 데 특화돼 있습니다. 검색뿐 아니라 URL 콘텐츠 추출과 사이트 맵/크롤도 함께 제공합니다."
          },
          {
            "q": "가져온 웹 콘텐츠를 그대로 신뢰해도 되나요?",
            "a": "아니요. 외부 웹 본문에는 프롬프트 인젝션 같은 악성 지시가 섞일 수 있으므로 추출 결과는 명령이 아닌 데이터로만 다뤄야 합니다. 중요한 사실은 출처를 직접 확인하는 것이 안전합니다."
          }
        ],
        "relatedIds": [
          "mcp-firecrawl",
          "mcp-exa",
          "mcp-brightdata"
        ]
      }
    },
    {
      "id": "mcp-exa",
      "type": "mcp",
      "name": "Exa MCP",
      "description": "Exa 검색 엔진 기반 웹 검색 및 웹 크롤링을 제공하는 공식 Exa MCP 서버. 시맨틱 검색에 강점.",
      "useWhen": "키워드 매칭이 아닌 의미 기반(시맨틱) 웹 검색으로 양질의 출처를 찾고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [
          "node"
        ],
        "task": [
          "web-search",
          "crawling",
          "research"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add --transport http exa \"https://mcp.exa.ai/mcp?tools=web_search_exa\"",
        "env": [
          "EXA_API_KEY"
        ],
        "secrets": [
          "EXA_API_KEY"
        ]
      },
      "source_url": "https://github.com/exa-labs/exa-mcp-server",
      "popularity": "공식 exa-labs 서버. npm exa-mcp-server로 배포, 시맨틱 검색 MCP로 널리 사용됨.",
      "seo": {
        "seoTitle": "Exa MCP 서버 — Claude Code 시맨틱 웹 검색·크롤링 연동",
        "metaDescription": "Exa 검색 엔진을 Claude Code에 붙이는 공식 Exa MCP 서버. 시맨틱 웹 검색과 크롤링으로 최신 정보·리서치를 에이전트가 직접 가져오게 한다. 설치·보안·활용 가이드.",
        "summary": "Exa MCP는 Exa 검색 엔진을 Claude Code(및 MCP 호환 클라이언트)에 연결하는 공식 MCP 서버입니다. AI 모델은 본래 학습 시점 이후의 최신 웹 정보에 접근하지 못하고, 출처가 불분명한 답을 생성하기 쉽습니다. Exa MCP는 이 한계를 메우기 위해 에이전트가 도구 호출로 직접 웹을 검색하고, 필요한 페이지 내용을 가져오게(crawling) 해 줍니다.\n\n핵심 강점은 \"시맨틱(의미 기반) 검색\"입니다. 키워드 일치에 의존하는 전통 검색과 달리, 질의의 의도와 의미에 가까운 문서를 찾도록 설계돼 리서치·근거 수집·경쟁 조사처럼 정확한 출처가 중요한 작업에 유용합니다. 설치 예시에서는 `web_search_exa` 도구가 노출돼, Claude가 자연어 질의로 웹을 검색하고 결과를 답변 근거로 활용할 수 있습니다. Exa는 이 외에도 다양한 도구 옵션을 제공하므로, 활성화할 도구 구성은 공식 문서 확인을 권장합니다.\n\n이런 분들에게 적합합니다. (1) Claude Code로 최신 뉴스·기술 동향·문서를 조사해 정리하는 리서치 워크플로, (2) 코드/제품 결정을 위해 외부 자료의 근거와 인용을 모아야 하는 개발자, (3) 블로그·콘텐츠 제작 시 사실 확인과 출처 수집이 필요한 작성자입니다. 본 프로젝트처럼 블로그 콘텐츠를 다루는 환경에서도 주제 리서치와 사실 확인 보조로 쓸 수 있습니다.\n\n연결 방식은 HTTP 트랜스포트를 사용하는 원격 MCP 엔드포인트이며, 호출에는 Exa API 키(`EXA_API_KEY`)가 필요합니다. Tavily·Firecrawl 등 다른 검색/크롤링 MCP와 목적이 겹치므로, 검색 품질·요금·도구 구성을 비교해 선택하면 좋습니다. 정확한 도구 목록·요금·한도는 공식 GitHub(exa-labs/exa-mcp-server)와 Exa 문서를 확인하세요.",
        "whenToUse": "최신 웹 정보가 답변 정확도를 좌우하는 작업에 적합합니다. 기술 동향·뉴스·문서 조사, 근거와 출처를 모아야 하는 리서치, 블로그·콘텐츠 제작 시 사실 확인, 경쟁/제품 조사 등에서 Claude가 직접 의미 기반 웹 검색과 페이지 크롤링을 수행하게 할 때 쓰세요. 학습 시점 이후 정보가 필요하거나, 단순 키워드 매칭으로는 원하는 문서가 안 잡힐 때 특히 유용합니다.",
        "installNotes": "HTTP 트랜스포트를 쓰는 원격 MCP 엔드포인트로 연결하며, 호출에는 Exa API 키(`EXA_API_KEY`)가 필요합니다. Exa 계정에서 키를 발급해 환경변수로 설정하세요. 설치 예시에서는 쿼리스트링으로 `web_search_exa` 도구만 활성화하지만, Exa는 다른 도구도 제공하므로 어떤 도구를 노출할지는 용도에 맞게 구성하고 공식 문서(exa-labs/exa-mcp-server)에서 최신 도구 목록·옵션을 확인하는 것을 권장합니다. 등록 후 도구 목록이 정상 노출되는지 점검하세요.",
        "securityNotes": "Exa API 키(`EXA_API_KEY`)는 결제·사용량과 직결되는 비밀키이므로 코드·로그·커밋에 노출하지 말고 환경변수나 시크릿 저장소로만 관리하세요. 키 유출 시 무단 호출로 요금이 발생할 수 있습니다. 원격 엔드포인트로 검색 질의가 외부(Exa)로 전송되므로, 사내 비공개 정보·개인정보를 질의에 담지 않도록 주의하세요. 또한 웹 검색·크롤링 결과는 외부 콘텐츠이므로 프롬프트 인젝션 위험이 있습니다 — 가져온 페이지 내용을 신뢰 가능한 지시로 취급하지 말고, 에이전트가 그 안의 명령을 그대로 실행하지 않도록 검증·격리하세요. 사용량 한도와 요금 정책은 공식 문서로 확인하길 권장합니다.",
        "faq": [
          {
            "q": "Exa MCP를 쓰려면 API 키가 꼭 필요한가요?",
            "a": "네. 검색 호출에 Exa API 키(EXA_API_KEY)가 필요합니다. Exa 계정에서 키를 발급해 환경변수로 설정한 뒤 사용하세요. 사용량·요금 정책은 공식 문서 확인을 권장합니다."
          },
          {
            "q": "Tavily, Firecrawl 같은 다른 검색 MCP와 무엇이 다른가요?",
            "a": "모두 웹 검색·크롤링을 에이전트에 제공한다는 점은 비슷합니다. Exa는 의미 기반(시맨틱) 검색에 강점을 두는 것으로 알려져 있어 리서치·근거 수집에 적합합니다. 검색 품질·요금·도구 구성을 비교해 선택하세요."
          },
          {
            "q": "설치 예시의 web_search_exa 외 다른 도구도 쓸 수 있나요?",
            "a": "예시는 web_search_exa만 활성화하지만 Exa는 추가 도구를 제공합니다. 활성화할 도구 구성과 최신 목록은 공식 GitHub(exa-labs/exa-mcp-server)와 Exa 문서에서 확인하세요."
          }
        ],
        "relatedIds": [
          "mcp-tavily",
          "mcp-firecrawl",
          "mcp-brightdata"
        ]
      }
    },
    {
      "id": "mcp-brightdata",
      "type": "mcp",
      "name": "Bright Data MCP",
      "description": "안티봇 우회까지 포함해 공개 웹 검색·스크래핑·구조화 추출을 제공하는 공식 Bright Data MCP 서버.",
      "useWhen": "차단·CAPTCHA·지역 제한이 있는 사이트를 안정적으로 스크래핑하거나 대규모 공개 웹 데이터를 추출해야 할 때.",
      "tags": {
        "framework": [],
        "lang": [
          "node"
        ],
        "task": [
          "web-scraping",
          "web-search",
          "data-extraction",
          "anti-bot"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add brightdata -e API_TOKEN=<BRIGHTDATA_API_TOKEN> -- npx -y @brightdata/mcp",
        "env": [
          "API_TOKEN"
        ],
        "secrets": [
          "API_TOKEN"
        ]
      },
      "source_url": "https://github.com/brightdata/brightdata-mcp",
      "popularity": "공식 Bright Data 서버. npm @brightdata/mcp로 배포, 안티봇 스크래핑 분야 대표 서버.",
      "seo": {
        "seoTitle": "Bright Data MCP 서버 — Claude Code 웹 검색·스크래핑·안티봇 우회 설치 가이드",
        "metaDescription": "Bright Data MCP는 공개 웹 검색·스크래핑·구조화 데이터 추출을 안티봇 우회까지 포함해 제공하는 공식 MCP 서버. Claude Code에 npx로 연결하는 설치·보안 가이드.",
        "summary": "Bright Data MCP는 Bright Data가 공식 제공하는 MCP(Model Context Protocol) 서버로, Claude Code 같은 MCP 클라이언트가 공개 웹을 검색하고 페이지를 스크래핑하며 구조화된 데이터로 추출할 수 있게 해 줍니다. 가장 큰 특징은 단순 HTTP 요청으로는 막히기 쉬운 사이트에 대해 안티봇(anti-bot) 우회까지 포함한다는 점으로, 봇 차단·CAPTCHA·동적 렌더링 등으로 직접 fetch가 어려운 페이지의 내용을 에이전트가 받아올 수 있도록 설계돼 있습니다.\n\n해결하는 문제는 명확합니다. LLM/에이전트가 최신 웹 정보를 활용하려 할 때, 일반적인 페이지 가져오기는 봇 차단이나 자바스크립트 렌더링 때문에 빈 결과를 받기 쉽습니다. Bright Data MCP는 이 수집 계층을 대신 처리해, 에이전트가 \"무엇을 찾을지\"에 집중하고 \"어떻게 가져올지\"는 서버에 위임하게 합니다. 이를 통해 검색 결과 수집, 특정 URL 본문 추출, 반복 가능한 구조화 추출 같은 워크플로를 에이전트 안에서 연결할 수 있습니다.\n\n핵심 기능은 (1) 공개 웹 검색(web-search), (2) 페이지 스크래핑(web-scraping), (3) 구조화 데이터 추출(data-extraction), (4) 안티봇 우회를 통한 접근성 확보입니다. 서버는 Node 기반으로 npx로 실행되며, 동작에는 Bright Data 계정에서 발급한 API 토큰(API_TOKEN)이 필요합니다.\n\n이런 분께 적합합니다: 시장·가격·뉴스 등 외부 웹 데이터를 에이전트로 수집해야 하는 리서치/모니터링 작업자, 차단이 잦은 사이트에서 안정적으로 콘텐츠를 받아와야 하는 개발자, 검색→수집→구조화를 하나의 에이전트 파이프라인으로 묶으려는 팀입니다. 구체적인 도구 목록·사용량 한도·과금 단위·정확한 동작은 버전에 따라 달라질 수 있으니, 공식 GitHub(brightdata/brightdata-mcp) 문서 확인을 권장합니다.",
        "whenToUse": "에이전트가 최신 웹 정보를 검색하고, 봇 차단·동적 렌더링으로 직접 fetch가 어려운 페이지의 본문을 받아와야 할 때 적합합니다. 가격·뉴스·경쟁사 페이지 모니터링, 검색 결과 수집 후 구조화 추출까지 하나의 흐름으로 묶고 싶을 때 유용합니다. 단순 정적 페이지 한두 개만 읽으면 되는 경우엔 기본 fetch로 충분할 수 있습니다.",
        "installNotes": "Node 환경에서 npx로 실행되므로 Node.js가 설치돼 있어야 하며, 첫 실행 시 패키지를 내려받습니다. 동작에는 Bright Data 계정에서 발급한 API_TOKEN이 필수이며, 토큰 없이는 인증 오류가 납니다. 제공되는 도구·사용량 한도·과금 단위는 플랜과 버전에 따라 달라질 수 있으니 등록 전 공식 GitHub(brightdata/brightdata-mcp) 문서로 최신 사양을 확인하길 권장합니다.",
        "securityNotes": "동작에 Bright Data API_TOKEN(비밀키)이 필요합니다. 이 토큰은 계정·과금에 연결되므로 환경변수로만 주입하고 코드·로그·커밋에 노출하지 마세요. 유출 시 무단 사용으로 직접 과금 피해가 발생할 수 있으며, 스크래핑·검색은 사용량 기반 비용이 발생할 수 있으니 한도와 빈도를 통제하세요. 또한 외부 웹에서 가져온 콘텐츠에는 프롬프트 인젝션이 섞일 수 있으므로, 수집 결과를 신뢰된 지시로 취급하지 말고 실행·민감작업 전 검증하세요. 대상 사이트의 약관·robots·관련 법규 준수도 사용자 책임입니다.",
        "faq": [
          {
            "q": "동작에 Bright Data 계정과 API 토큰이 꼭 필요한가요?",
            "a": "네. Bright Data에서 발급한 API_TOKEN을 환경변수로 넣어야 인증되며, 토큰 없이는 검색·스크래핑이 동작하지 않습니다. 토큰은 계정·과금에 연결되니 노출에 주의하세요."
          },
          {
            "q": "Firecrawl·Tavily·Exa 같은 도구와 무엇이 다른가요?",
            "a": "공통적으로 웹 검색·수집을 제공하지만, Bright Data MCP는 안티봇 우회를 포함해 봇 차단이 잦은 사이트 접근에 강점을 둡니다. 정확한 도구·한도·과금은 각 서비스 공식 문서를 비교 확인하길 권장합니다."
          },
          {
            "q": "비용이 발생하나요?",
            "a": "스크래핑·검색은 일반적으로 사용량 기반 과금이 적용될 수 있습니다. 플랜·단가는 버전에 따라 달라지니 공식 문서를 확인하고, 자동화 시 호출 빈도와 한도를 통제하세요."
          }
        ],
        "relatedIds": [
          "mcp-firecrawl",
          "mcp-tavily",
          "mcp-exa"
        ]
      }
    },
    {
      "id": "mcp-apify-actors",
      "type": "mcp",
      "name": "Apify Actors MCP",
      "description": "Apify Store의 수천 개 스크래퍼/크롤러(Actor)를 호출해 소셜·검색·지도·이커머스 등 데이터를 추출하는 공식 Apify MCP 서버.",
      "useWhen": "직접 스크래퍼를 만들지 않고 기성 Actor로 특정 사이트(인스타·구글맵·아마존 등) 데이터를 뽑고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [
          "node"
        ],
        "task": [
          "web-scraping",
          "crawling",
          "data-extraction",
          "automation"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add apify-actors -e APIFY_TOKEN=<APIFY_TOKEN> -- npx -y @apify/actors-mcp-server",
        "env": [
          "APIFY_TOKEN"
        ],
        "secrets": [
          "APIFY_TOKEN"
        ]
      },
      "source_url": "https://github.com/apify/apify-mcp-server",
      "popularity": "공식 Apify 서버. npm @apify/actors-mcp-server로 배포, 기성 스크래퍼 생태계와 연동되어 널리 사용됨.",
      "seo": {
        "seoTitle": "Apify Actors MCP 서버 — Claude Code로 웹 스크래핑·데이터 추출 자동화",
        "metaDescription": "Apify Store의 수천 개 스크래퍼/크롤러(Actor)를 Claude Code에서 호출해 소셜·검색·지도·이커머스 데이터를 추출하는 공식 Apify MCP 서버. 설치·설정·보안 주의점 정리.",
        "summary": "Apify Actors MCP는 Apify Store에 공개된 수천 개의 스크래퍼·크롤러(이들을 Apify에서는 \"Actor\"라 부른다)를 Claude Code 같은 MCP 클라이언트에서 직접 호출할 수 있게 해주는 공식 Apify MCP 서버입니다. 별도의 스크래핑 코드를 직접 작성하지 않아도, 에이전트가 자연어 요청을 받아 적절한 Actor를 찾고 입력값을 구성해 실행한 뒤, 추출된 구조화 데이터를 받아오는 흐름을 제공합니다.\n\n해결하는 문제는 명확합니다. 웹 데이터 추출은 페이지 구조 파싱, 페이지네이션, 봇 차단·캡차 우회, 프록시 로테이션 등 손이 많이 가는 작업입니다. Apify는 이런 기능을 갖춘 검증된 Actor들을 마켓플레이스 형태로 제공하고, 이 MCP 서버는 그 카탈로그를 에이전트 도구로 노출합니다. 그 결과 소셜 미디어 게시물·프로필, 검색엔진 결과, 지도/장소 정보, 이커머스 상품·가격, 일반 웹 크롤링 등 다양한 소스에서 데이터를 끌어올 수 있습니다.\n\n핵심 기능은 (1) 사용 가능한 Actor 탐색·검색, (2) 특정 Actor의 입력 스키마 확인, (3) Actor 실행과 결과(데이터셋) 회수입니다. 실제로 노출되는 도구 구성과 기본 동작은 버전에 따라 달라질 수 있으므로 정확한 도구 목록과 옵션은 공식 문서(github.com/apify/apify-mcp-server) 확인을 권장합니다.\n\n누가 쓰면 좋은가: 리서치·시장조사·가격 모니터링·리드 수집·콘텐츠 수집처럼 반복적인 웹 데이터 추출이 필요한 사용자, 그리고 스크래퍼를 매번 직접 구현하기보다 검증된 Actor를 에이전트 워크플로에 끼워 넣고 싶은 개발자·분석가에게 적합합니다. Node(npx) 환경에서 동작하며 Apify 계정과 토큰만 있으면 빠르게 붙일 수 있습니다.",
        "whenToUse": "소셜·검색·지도·이커머스·일반 웹 등에서 구조화된 데이터를 반복적으로 추출해야 할 때, 그리고 매번 스크래퍼를 직접 구현하기보다 Apify Store의 검증된 Actor를 에이전트 워크플로에 바로 끼워 쓰고 싶을 때 적합합니다. 시장조사, 가격·재고 모니터링, 리서치 데이터 수집, 리드/콘텐츠 수집 같은 작업에 유용합니다. 단순한 한 페이지 추출이나 공식 API가 따로 있는 데이터라면 굳이 필요하지 않을 수 있습니다.",
        "installNotes": "Node 환경이 필요하며 npx로 패키지를 받아 실행하는 방식입니다(첫 실행 시 다운로드 발생). 사전에 Apify 계정을 만들고 콘솔에서 API 토큰(APIFY_TOKEN)을 발급해 환경변수로 전달해야 합니다. 사용하려는 Actor마다 입력 스키마와 출력 형식, 과금 단위가 다르므로 실행 전 해당 Actor 문서를 확인하는 것이 좋습니다. 노출되는 도구 구성·기본 옵션은 서버 버전에 따라 달라질 수 있어, 정확한 사양은 공식 문서(github.com/apify/apify-mcp-server) 확인을 권장합니다.",
        "securityNotes": "APIFY_TOKEN은 본인 Apify 계정에 대한 인증 키이므로 유출 시 계정의 Actor 실행·과금이 가능해집니다. 토큰은 환경변수로만 주입하고 코드·로그·커밋에 노출하지 마세요(.env는 gitignore 권장). Apify는 사용량 기반 과금이므로 에이전트가 무분별하게 Actor를 반복 실행하면 비용이 빠르게 누적될 수 있어, 대상 Actor와 실행 횟수를 통제하는 것이 안전합니다. 또한 스크래핑으로 들어온 외부 웹 콘텐츠에는 프롬프트 인젝션 위험이 있으므로, 추출 결과를 그대로 신뢰해 후속 명령으로 실행하지 말고 검토 후 사용하세요. 대상 사이트의 이용약관·robots·개인정보 규정 준수 책임은 사용자에게 있습니다.",
        "faq": [
          {
            "q": "APIFY_TOKEN은 어디서 발급하나요?",
            "a": "Apify 계정을 만든 뒤 Apify 콘솔의 계정/Integrations 영역에서 API 토큰을 발급해 APIFY_TOKEN 환경변수로 전달합니다. 정확한 경로와 권한 범위는 공식 문서 확인을 권장합니다."
          },
          {
            "q": "사용 비용이 드나요?",
            "a": "Apify는 사용량 기반 과금이라 Actor 실행이 늘수록 비용이 발생할 수 있습니다. Actor마다 과금 단위가 다르므로 실행 전 해당 Actor 문서를 확인하고, 에이전트의 반복 실행을 통제하는 것이 좋습니다."
          },
          {
            "q": "어떤 종류의 데이터를 추출할 수 있나요?",
            "a": "Apify Store의 Actor에 따라 소셜 미디어, 검색 결과, 지도/장소, 이커머스 상품·가격, 일반 웹 크롤링 등 다양합니다. 사용 가능한 Actor 목록과 입력 스키마는 서버를 통해 탐색하거나 공식 문서에서 확인할 수 있습니다."
          }
        ],
        "relatedIds": [
          "mcp-firecrawl",
          "mcp-brightdata",
          "mcp-tavily"
        ]
      }
    },
    {
      "id": "mcp-browserbase",
      "type": "mcp",
      "name": "Browserbase MCP (Stagehand)",
      "description": "Browserbase 클라우드 브라우저와 Stagehand를 통해 LLM이 실제 브라우저를 자연어로 제어·자동화하게 해주는 공식 MCP 서버.",
      "useWhen": "로그인·폼 제출·다단계 클릭 같은 동적 브라우저 자동화를 클라우드 브라우저에서 수행하고 싶을 때.",
      "tags": {
        "framework": [
          "stagehand"
        ],
        "lang": [
          "node"
        ],
        "task": [
          "browser-automation",
          "web-scraping",
          "automation"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add browserbase -e BROWSERBASE_API_KEY=<BROWSERBASE_API_KEY> -e BROWSERBASE_PROJECT_ID=<BROWSERBASE_PROJECT_ID> -- npx -y @browserbasehq/mcp",
        "env": [
          "BROWSERBASE_API_KEY",
          "BROWSERBASE_PROJECT_ID"
        ],
        "secrets": [
          "BROWSERBASE_API_KEY",
          "BROWSERBASE_PROJECT_ID"
        ]
      },
      "source_url": "https://github.com/browserbase/mcp-server-browserbase",
      "popularity": "공식 Browserbase 서버. Stagehand 기반 자연어 브라우저 제어로 널리 사용됨(원격 호스팅 URL도 제공).",
      "seo": {
        "seoTitle": "Browserbase MCP (Stagehand) - Claude로 클라우드 브라우저 자동화",
        "metaDescription": "Browserbase 클라우드 브라우저와 Stagehand를 통해 Claude가 실제 브라우저를 자연어로 제어·자동화·스크래핑하게 해주는 공식 MCP 서버. 설치·보안 주의점 정리.",
        "summary": "Browserbase MCP는 Browserbase의 클라우드 브라우저 인프라와 Stagehand 자동화 프레임워크를 묶어, LLM(Claude 등)이 실제 웹 브라우저를 자연어 지시로 제어할 수 있게 해주는 공식 MCP 서버입니다. 헤드리스 브라우저를 직접 띄우고 셀렉터를 일일이 작성하던 기존 방식 대신, \"로그인 폼에 값을 채우고 제출해라\", \"이 페이지에서 가격 목록을 추출해라\" 같은 자연어 의도를 Stagehand가 실제 브라우저 동작(클릭·입력·이동·관찰)으로 변환합니다.\n\n핵심적으로 해결하는 문제는 두 가지입니다. 첫째, 자바스크립트로 렌더링되는 동적 사이트는 단순 HTTP 요청으로는 내용을 가져올 수 없는데, 실제 브라우저를 띄워 렌더링 후 데이터를 추출하므로 SPA·로그인 뒤 페이지·동적 콘텐츠도 다룰 수 있습니다. 둘째, 브라우저 실행 환경을 로컬에 구성·유지하는 부담을 Browserbase 클라우드가 대신 맡아, 세션 관리·확장성·격리된 실행 환경을 위임할 수 있습니다.\n\n주요 기능은 자연어 기반 브라우저 액션 수행, 페이지 관찰·구조화된 데이터 추출, 멀티스텝 웹 자동화, 그리고 클라우드 세션을 통한 스크래핑입니다. Stagehand가 의도를 동작으로 번역하는 계층 역할을 하므로, 깨지기 쉬운 하드코딩 셀렉터 의존도를 낮출 수 있습니다.\n\n추천 대상은 동적 웹사이트에서 데이터를 수집해야 하는 데이터 엔지니어·리서처, 반복적인 웹 업무를 에이전트로 자동화하려는 개발자, 로컬 브라우저 환경 없이 클라우드에서 안정적으로 자동화를 돌리려는 팀입니다. Node 기반(npx)으로 설치하며 실행에는 Browserbase API 키와 프로젝트 ID가 필요합니다. 세부 기능·옵션은 버전에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다.",
        "whenToUse": "자바스크립트로 렌더링되는 동적 사이트나 로그인 뒤 페이지에서 데이터를 추출해야 할 때, 단순 HTTP 스크래핑이 막힐 때 적합합니다. 로그인·폼 입력·다단계 탐색 같은 멀티스텝 웹 작업을 자연어로 자동화하거나, 로컬에 브라우저 실행 환경을 두지 않고 클라우드 세션으로 안정적·확장적으로 돌리고 싶을 때 유용합니다. 셀렉터 하드코딩을 줄이고 의도 기반으로 자동화를 작성하려는 경우에도 좋습니다.",
        "installNotes": "Node.js 환경이 필요하며 npx로 패키지를 받아 실행합니다. 실행 전 Browserbase 계정에서 API 키와 프로젝트 ID를 발급받아 환경변수 BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID로 전달해야 합니다. 둘 중 하나라도 누락되면 세션 생성이 실패합니다. 클라우드 브라우저 사용량에 따라 Browserbase 요금이 발생할 수 있으니 무료 한도·플랜을 사전에 확인하세요. 패키지명·옵션·지원 도구는 버전에 따라 바뀔 수 있으므로 공식 문서 확인을 권장합니다.",
        "securityNotes": "BROWSERBASE_API_KEY와 BROWSERBASE_PROJECT_ID는 클라우드 브라우저 세션을 생성·과금하는 비밀키이므로 절대 커밋·로그·공유하지 말고 환경변수/시크릿 매니저로만 주입하세요. 이 서버는 실제 브라우저로 로그인·폼 제출·데이터 입력 등 부수효과 있는 동작을 수행하므로, LLM이 의도치 않은 사이트에서 결제·삭제·전송을 일으키지 않도록 권한과 대상 도메인을 통제해야 합니다. 특히 가져온 웹 페이지 본문에 악의적 지시가 숨겨져 모델을 조종하는 프롬프트 인젝션 위험이 크니, 추출 콘텐츠는 신뢰하지 말고 자동 실행 액션을 검토·승인 게이트로 제한하세요. 자격증명을 다루는 자동화는 격리된 세션에서 최소 권한으로 운영하길 권장합니다.",
        "faq": [
          {
            "q": "단순 HTTP 스크래핑 도구와 무엇이 다른가요?",
            "a": "실제 클라우드 브라우저를 띄워 페이지를 렌더링한 뒤 다루므로, 자바스크립트로 그려지는 동적 사이트나 로그인 뒤 페이지처럼 단순 HTTP 요청으로는 내용을 얻을 수 없는 경우까지 처리할 수 있습니다. 또한 Stagehand가 자연어 의도를 클릭·입력 같은 실제 동작으로 변환합니다."
          },
          {
            "q": "실행에 어떤 키가 필요한가요?",
            "a": "Browserbase API 키(BROWSERBASE_API_KEY)와 프로젝트 ID(BROWSERBASE_PROJECT_ID)가 필요합니다. Browserbase 계정에서 발급해 환경변수로 전달하며, 둘 중 하나라도 없으면 세션 생성이 실패합니다."
          },
          {
            "q": "비용이 발생하나요?",
            "a": "클라우드 브라우저 세션을 사용하므로 사용량에 따라 Browserbase 요금이 발생할 수 있습니다. 무료 한도와 요금 정책은 공식 문서·대시보드에서 확인하세요."
          }
        ],
        "relatedIds": [
          "mcp-hyperbrowser",
          "mcp-firecrawl",
          "mcp-puppeteer-hisma"
        ]
      }
    },
    {
      "id": "mcp-hyperbrowser",
      "type": "mcp",
      "name": "Hyperbrowser MCP",
      "description": "스크래핑·구조화 추출·크롤링과 함께 범용 브라우저 에이전트(Computer Use, Browser Use 등)를 제공하는 공식 Hyperbrowser MCP 서버.",
      "useWhen": "스크래핑부터 에이전트 기반 브라우저 작업까지 한 서버에서 처리하고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [
          "node"
        ],
        "task": [
          "browser-automation",
          "web-scraping",
          "crawling",
          "data-extraction"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add hyperbrowser -e HYPERBROWSER_API_KEY=<HYPERBROWSER_API_KEY> -- npx -y hyperbrowser-mcp",
        "env": [
          "HYPERBROWSER_API_KEY"
        ],
        "secrets": [
          "HYPERBROWSER_API_KEY"
        ]
      },
      "source_url": "https://github.com/hyperbrowserai/mcp",
      "popularity": "공식 hyperbrowserai 서버. npm hyperbrowser-mcp로 배포, YC 런칭으로 알려짐.",
      "seo": {
        "seoTitle": "Hyperbrowser MCP: Claude Code용 브라우저 에이전트·웹 스크래핑 서버",
        "metaDescription": "Hyperbrowser MCP는 Claude Code에 스크래핑·구조화 추출·크롤링과 Computer Use/Browser Use 같은 브라우저 에이전트를 연결하는 공식 MCP 서버입니다. Node 기반, API 키 필요.",
        "summary": "Hyperbrowser MCP는 Hyperbrowser가 공식 제공하는 MCP(Model Context Protocol) 서버로, Claude Code 같은 MCP 호환 AI 클라이언트에 클라우드 기반 헤드리스 브라우저 기능을 연결해 줍니다. 핵심은 두 갈래입니다. 첫째는 웹 데이터 수집 — 단일 페이지 스크래핑, 사이트 단위 크롤링, 그리고 자유 텍스트 HTML에서 원하는 필드만 뽑아내는 구조화 추출(data extraction)을 제공합니다. 둘째는 범용 브라우저 에이전트 — Computer Use, Browser Use 등으로 대표되는 에이전트형 자동화로, 모델이 실제 브라우저를 조작해 페이지를 탐색·클릭·입력하며 작업을 수행하도록 합니다.\n\n이 서버가 푸는 문제는 분명합니다. LLM 단독으로는 최신 웹 콘텐츠에 접근하거나, JavaScript로 렌더링되는 동적 페이지를 읽거나, 로그인·페이지네이션이 얽힌 멀티스텝 브라우징을 수행하기 어렵습니다. Hyperbrowser MCP는 이를 관리형 원격 브라우저 인프라로 대신 처리하고, 결과를 모델이 바로 쓰기 좋은 형태(텍스트·구조화 데이터)로 돌려줍니다. 로컬에 브라우저 드라이버나 봇 우회 스택을 직접 구축·유지하지 않아도 된다는 점이 장점입니다.\n\n이런 분들에게 적합합니다. 리서치·시장 조사·가격 모니터링처럼 여러 페이지에서 데이터를 모아 구조화해야 하는 작업, 문서가 흩어진 사이트를 크롤링해 요약·색인하려는 작업, 그리고 폼 작성·플로우 검증 같은 에이전트형 브라우저 자동화가 필요한 작업입니다. Node(npx) 환경에서 실행되며 사용에는 Hyperbrowser API 키(HYPERBROWSER_API_KEY)가 필요합니다. 제공 도구의 정확한 목록·인자·요금제는 버전에 따라 달라질 수 있으니 공식 GitHub 저장소(hyperbrowserai/mcp)와 Hyperbrowser 문서를 확인하는 것을 권장합니다.",
        "whenToUse": "동적(JS 렌더링) 페이지를 읽거나, 여러 페이지를 크롤링해 구조화 데이터로 추출하거나, 로그인·클릭·입력이 필요한 멀티스텝 브라우저 작업을 에이전트로 자동화할 때 적합합니다. 로컬에 브라우저 드라이버·봇 우회 스택을 직접 운영하기 부담스럽고, 관리형 원격 브라우저로 위임하고 싶을 때 유용합니다. 단순 정적 텍스트 한두 페이지만 필요하면 가벼운 검색·페치 MCP로 충분할 수 있습니다.",
        "installNotes": "Node.js 환경이 필요하며 npx로 패키지를 받아 실행합니다. 사용 전에 Hyperbrowser 계정에서 API 키(HYPERBROWSER_API_KEY)를 발급해 환경변수로 전달해야 합니다. 키 없이는 브라우저 세션이 동작하지 않습니다. 원격 클라우드 브라우저를 호출하므로 네트워크 연결이 필요하고, 크롤링·세션 사용량에 따라 요금이 발생할 수 있으니 요금제를 먼저 확인하세요. 제공 도구의 정확한 이름·인자·기본값은 버전마다 바뀔 수 있어 공식 GitHub(hyperbrowserai/mcp)와 Hyperbrowser 문서로 확인하는 것을 권장합니다.",
        "securityNotes": "HYPERBROWSER_API_KEY는 과금·세션 권한이 묶인 비밀키입니다. 유출 시 무단 사용·비용 폭증으로 이어질 수 있으니 셸 히스토리·로그·커밋에 노출하지 말고 환경변수나 시크릿 매니저로만 주입하세요. 크롤링·추출하는 페이지의 robots 정책과 이용약관, 개인정보·저작권을 준수해야 하며, 로그인 자격증명을 다루는 자동화는 신뢰 가능한 대상으로 제한하세요. 특히 외부 웹 콘텐츠를 모델 컨텍스트로 들여오는 만큼 프롬프트 인젝션 위험이 큽니다 — 페이지 본문에 숨겨진 지시가 에이전트를 조종할 수 있으므로, 가져온 내용을 신뢰 입력으로 취급하지 말고 민감 작업은 사람 승인 게이트를 두세요.",
        "faq": [
          {
            "q": "Hyperbrowser MCP를 쓰려면 무엇이 필요한가요?",
            "a": "Node.js(npx) 실행 환경과 Hyperbrowser API 키(HYPERBROWSER_API_KEY)가 필요합니다. 키는 Hyperbrowser 계정에서 발급하며 환경변수로 전달합니다. 브라우저는 원격 클라우드에서 동작하므로 네트워크 연결이 필요합니다."
          },
          {
            "q": "스크래핑과 브라우저 에이전트는 어떻게 다른가요?",
            "a": "스크래핑·크롤링·구조화 추출은 페이지 콘텐츠를 읽어 데이터로 돌려주는 데 초점이 있고, Computer Use·Browser Use 같은 에이전트형 도구는 모델이 실제 브라우저를 조작해 클릭·입력 등 멀티스텝 작업을 수행하게 합니다. 정확한 도구 목록은 공식 저장소를 확인하세요."
          },
          {
            "q": "비용이 드나요?",
            "a": "Hyperbrowser는 관리형 클라우드 브라우저 서비스이므로 크롤링·세션 사용량에 따라 과금될 수 있습니다. 정확한 요금제와 무료 한도는 Hyperbrowser 공식 문서에서 확인하는 것을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-firecrawl",
          "mcp-browserbase",
          "mcp-apify-actors"
        ]
      }
    },
    {
      "id": "mcp-puppeteer-hisma",
      "type": "mcp",
      "name": "Puppeteer MCP (hisma maintained fork)",
      "description": "Puppeteer로 로컬 브라우저를 띄워 페이지 탐색·클릭·입력·스크린샷·JS 실행을 수행하는 MCP 서버. 아카이브된 공식 server-puppeteer의 유지보수 포크.",
      "useWhen": "API 키 없이 로컬에서 무료로 브라우저 자동화/스크린샷/DOM 조작을 하고 싶을 때(원래 공식 패키지는 deprecated).",
      "tags": {
        "framework": [
          "puppeteer"
        ],
        "lang": [
          "node"
        ],
        "task": [
          "browser-automation",
          "web-scraping",
          "screenshot"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add puppeteer -- npx -y @hisma/server-puppeteer",
        "env": []
      },
      "source_url": "https://www.npmjs.com/package/@hisma/server-puppeteer",
      "popularity": "deprecated된 @modelcontextprotocol/server-puppeteer(v0.6.2)의 유지보수 포크. 로컬 브라우저 자동화용으로 널리 쓰임(추정).",
      "seo": {
        "seoTitle": "Puppeteer MCP (hisma 포크) — Claude Code 로컬 브라우저 자동화 MCP 서버",
        "metaDescription": "Puppeteer로 로컬 브라우저를 띄워 페이지 탐색·클릭·입력·스크린샷·JS 실행을 수행하는 MCP 서버. 아카이브된 공식 server-puppeteer의 유지보수 포크(@hisma/server-puppeteer)를 Claude Code에 연결하는 설치·보안 가이드.",
        "summary": "Puppeteer MCP(hisma maintained fork)는 Claude Code 같은 MCP 호스트가 로컬 Chromium/Chrome 브라우저를 직접 제어하도록 해 주는 Model Context Protocol 서버입니다. Node 기반으로 동작하며, 내부적으로 구글 Puppeteer 라이브러리를 사용해 AI가 자연어 지시만으로 실제 브라우저를 띄우고 조작할 수 있게 합니다.\n\n제공하는 핵심 동작은 페이지 이동(URL 탐색), 요소 클릭·폼 입력·선택, 스크린샷 캡처, 그리고 페이지 컨텍스트에서의 임의 JavaScript 실행입니다. 이를 통해 정적 HTML로는 얻기 어려운 동적·로그인 후·SPA 화면까지 렌더링된 상태로 다룰 수 있어, 웹 스크래핑·UI 동작 확인·반복 작업 자동화·시각적 회귀 점검(스크린샷) 같은 작업을 에이전트가 수행하도록 위임할 수 있습니다.\n\n이 패키지(@hisma/server-puppeteer)는 Anthropic의 공식 예제 모음에 있던 @modelcontextprotocol/server-puppeteer가 아카이브(유지보수 중단)된 뒤, 이를 이어받아 의존성과 동작을 갱신한 커뮤니티 유지보수 포크입니다. 따라서 기존 공식 server-puppeteer에 익숙한 사용자가 큰 변경 없이 옮겨 쓰기에 적합합니다.\n\n쓰면 좋은 대상은 다음과 같습니다. (1) 클라우드 브라우저 서비스 비용 없이 자신의 머신에서 브라우저 자동화를 돌리고 싶은 개발자, (2) 로그인·동적 렌더링이 필요한 페이지를 에이전트로 점검·수집하려는 사람, (3) 프런트엔드 변경을 스크린샷으로 빠르게 확인하려는 팀입니다. 반대로 대규모·고가용 크롤링이나 봇 차단 우회가 필요한 경우에는 Browserbase·Hyperbrowser·Bright Data 같은 관리형 서비스가 더 맞을 수 있습니다. 로컬에 Node 런타임과 브라우저 실행 환경이 필요하며, 헤드리스/헤드풀 동작 등 세부 옵션은 버전에 따라 다를 수 있으니 공식 npm 문서 확인을 권장합니다.",
        "whenToUse": "로그인 후 화면·SPA·동적 렌더링 페이지를 에이전트로 탐색·수집하거나, 폼 입력·클릭 같은 반복 웹 작업을 자동화하고 싶을 때 적합합니다. 프런트엔드 변경을 스크린샷으로 빠르게 확인하거나, 클라우드 브라우저 비용 없이 내 PC에서 직접 브라우저 자동화를 돌리고 싶을 때 좋습니다. 대규모·고가용 크롤링이나 봇 차단 우회가 핵심이면 관리형 서비스를 검토하세요.",
        "installNotes": "로컬에 Node.js와 Puppeteer가 구동할 Chromium/Chrome 실행 환경이 필요합니다. npx로 설치 시 첫 실행에서 브라우저 바이너리 다운로드나 런타임 의존성(특히 Linux의 공유 라이브러리)이 요구될 수 있어 시간이 걸리거나 실패할 수 있으니, 헤드리스/헤드풀 옵션과 시스템 의존성은 공식 npm 문서 확인을 권장합니다. 이 패키지는 아카이브된 공식 server-puppeteer의 커뮤니티 유지보수 포크이므로, 버전 고정·동작 호환은 배포 노트를 확인한 뒤 적용하세요. 별도 API 키나 환경변수는 요구하지 않습니다.",
        "securityNotes": "이 서버는 로컬 브라우저를 띄워 임의 URL을 열고 페이지 컨텍스트에서 JavaScript를 실행하므로 사실상 코드 실행 권한에 준합니다. 별도 API 키([])는 없지만, 에이전트가 방문하는 페이지의 콘텐츠가 곧 모델 입력이 되어 프롬프트 인젝션(악성 페이지가 에이전트에게 다른 행동을 지시) 위험이 큽니다. 신뢰할 수 없는 사이트를 자동 탐색시키지 말고, 로그인 세션·쿠키·저장된 자격증명이 노출·전송되지 않도록 주의하세요. 스크린샷에 민감정보가 담길 수 있고, 클릭/폼 제출이 결제·삭제 같은 비가역 동작을 유발할 수 있으니 가능하면 격리된 프로필·샌드박스 환경에서 실행하길 권장합니다.",
        "faq": [
          {
            "q": "공식 @modelcontextprotocol/server-puppeteer와 무엇이 다른가요?",
            "a": "기능은 사실상 동일합니다. 공식 패키지가 아카이브(유지보수 중단)된 뒤 이를 이어받아 의존성과 동작을 갱신한 커뮤니티 유지보수 포크가 @hisma/server-puppeteer입니다. 기존 설정에서 큰 변경 없이 옮겨 쓰기 적합하며, 세부 호환은 npm 배포 노트를 확인하세요."
          },
          {
            "q": "별도 API 키나 클라우드 계정이 필요한가요?",
            "a": "아니요. 로컬 브라우저를 직접 띄우는 방식이라 외부 API 키나 유료 계정이 필요 없습니다. 대신 로컬에 Node와 Chromium/Chrome 실행 환경이 있어야 하며, 첫 실행 시 브라우저 바이너리나 시스템 의존성이 요구될 수 있습니다."
          },
          {
            "q": "대규모 크롤링이나 봇 차단 우회에도 적합한가요?",
            "a": "기본적으로 로컬 단일 브라우저 자동화에 적합합니다. 대규모·고가용 크롤링, 프록시 회전, 봇 차단 우회가 핵심이라면 Browserbase·Hyperbrowser·Bright Data 같은 관리형 서비스가 더 적합할 수 있습니다."
          }
        ],
        "relatedIds": [
          "mcp-chrome-devtools",
          "mcp-browserbase",
          "mcp-hyperbrowser"
        ]
      }
    },
    {
      "id": "mcp-aws-documentation",
      "type": "mcp",
      "name": "AWS Documentation MCP (awslabs)",
      "description": "AWS 공식(awslabs) 문서 MCP 서버. AWS 공식 문서를 검색/조회하고 마크다운으로 변환, 관련 페이지를 추천한다.",
      "useWhen": "AWS 서비스 설정·API·CloudFormation 등 최신 공식 문서를 근거로 코드/구성을 작성할 때.",
      "tags": {
        "framework": [],
        "lang": [
          "python"
        ],
        "task": [
          "cloud",
          "aws",
          "documentation"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add aws-docs -- uvx awslabs.aws-documentation-mcp-server@latest",
        "env": []
      },
      "source_url": "https://github.com/awslabs/mcp",
      "popularity": "AWS 공식 awslabs/mcp 모음의 핵심 서버, 광범위하게 사용",
      "seo": {
        "seoTitle": "AWS Documentation MCP (awslabs) — AWS 공식 문서 검색·조회 MCP 서버",
        "metaDescription": "AWS 공식(awslabs) Documentation MCP 서버. Claude Code에서 AWS 문서를 검색·조회하고 마크다운으로 변환, 관련 페이지를 추천받아 정확한 클라우드 작업을 돕는다.",
        "summary": "AWS Documentation MCP는 Amazon Web Services가 awslabs 조직에서 공개·유지하는 공식 MCP(Model Context Protocol) 서버로, Claude Code 같은 MCP 클라이언트가 방대한 AWS 공식 문서를 직접 검색하고 조회할 수 있게 해준다. 핵심 동작은 세 가지다. 첫째, 문서 검색 — 키워드나 자연어 질의로 관련 AWS 문서 페이지를 찾는다. 둘째, 페이지 조회·변환 — 특정 문서 페이지를 가져와 LLM이 다루기 좋은 마크다운 형태로 변환해 제공한다. 셋째, 관련 페이지 추천 — 보고 있는 문서와 연관된 문서를 함께 제안해 맥락을 넓혀준다.\n\n이 서버가 푸는 문제는 명확하다. AWS는 서비스 수가 많고 문서가 자주 갱신되기 때문에, 모델의 학습 시점 지식만으로 답하면 옛 정보나 부정확한 API/CLI 사용법을 제시할 위험이 크다. AWS Documentation MCP를 붙이면 모델이 답변 시점에 공식 문서를 직접 조회해 근거 있는 답을 만들 수 있어, IAM 정책 예시, S3·Lambda·EC2 등 서비스 설정, CLI/SDK 사용법, 한도·요금 페이지 확인 같은 작업의 정확도가 올라간다. 마크다운 변환 덕분에 결과를 코드나 문서에 바로 인용·정리하기도 쉽다.\n\n누가 쓰면 좋은가. AWS 위에서 인프라를 짜거나 운영하는 개발자·DevOps·SRE, IaC(CloudFormation/CDK/Terraform)나 서버리스 구성을 작성하면서 공식 레퍼런스를 빈번히 확인하는 사람, AWS 학습 중 정확한 1차 출처를 원하는 사용자에게 적합하다. Python(uvx) 기반으로 배포되며 별도 API 키 없이 공개 문서를 다루는 구성이 일반적이지만, 옵션·동작 세부는 변동될 수 있으니 공식 저장소(awslabs/mcp) 문서를 확인하는 것을 권장한다. AWS 계정 자원을 직접 조작하는 도구가 아니라 어디까지나 \"문서\" 조회용임을 유념하면 된다.",
        "whenToUse": "AWS 서비스 설정·API·CLI/SDK 사용법을 최신 공식 문서 기준으로 확인하며 답을 만들고 싶을 때 적합하다. 모델의 옛 지식으로 인한 부정확을 줄이고, IAM 정책·서버리스·IaC 작성 시 1차 출처를 인용하고 싶을 때 유용하다. 검색→해당 페이지 마크다운 조회→관련 페이지 확장 흐름으로 AWS 문서 탐색을 자동화하려는 개발자·DevOps에게 권한다.",
        "installNotes": "Python 패키지를 uvx로 즉시 실행하는 방식이므로 사전에 Python 환경과 uv/uvx가 설치돼 있어야 한다(uvx가 없으면 명령이 실패). @latest 태그는 매 실행 시 최신 버전을 받으므로 첫 호출 시 네트워크 다운로드가 발생할 수 있고, 재현성이 중요하면 버전 고정을 고려한다. 추가/등록 후 MCP 클라이언트(Claude Code)에서 서버가 정상 연결됐는지 확인하고, 도구 이름·옵션·필요 런타임 등 세부는 변동될 수 있으니 awslabs/mcp 공식 저장소 문서를 확인하는 것을 권장한다.",
        "securityNotes": "이 서버는 공개된 AWS 공식 문서를 검색·조회하는 용도로, 위 구성상 별도 비밀키나 AWS 자격증명을 요구하지 않는다(env 비어 있음). 다만 외부에서 가져온 문서 본문이 모델 컨텍스트로 들어오므로, 문서나 검색 결과에 포함된 텍스트가 프롬프트 인젝션 통로가 될 가능성을 인지하고 그 내용을 무비판적으로 실행 지시로 받아들이지 않도록 주의한다. 실행 시 외부 패키지(uvx로 내려받는 코드)를 신뢰하는 것이므로 출처(awslabs)와 무결성을 확인한다. 이 도구 자체는 AWS 계정 자원을 생성·삭제·과금하지 않지만, 문서에서 본 명령을 실제 계정에 적용할 때는 권한·요금·삭제 영향을 별도로 검토해야 한다.",
        "faq": [
          {
            "q": "AWS 계정에 직접 접근하거나 리소스를 변경하나요?",
            "a": "아니요. 이 MCP는 AWS 공식 문서를 검색·조회·마크다운 변환하고 관련 페이지를 추천하는 문서 도구입니다. 계정 자원 생성·삭제·과금 같은 조작은 하지 않으며, 그 구성상 AWS 자격증명도 요구하지 않습니다. 다만 문서에서 얻은 명령을 실제 계정에 적용할 때는 권한·요금·영향을 별도로 확인하세요."
          },
          {
            "q": "실행에 무엇이 필요하고 API 키가 드나요?",
            "a": "uvx로 Python 패키지를 실행하는 방식이라 Python과 uv/uvx 환경이 필요합니다. 위 구성에서는 별도 API 키나 비밀키 설정이 없습니다. 런타임·옵션 세부는 바뀔 수 있으니 awslabs/mcp 공식 저장소 문서를 확인하는 것을 권장합니다."
          },
          {
            "q": "왜 모델에 그냥 묻지 않고 이 MCP를 쓰나요?",
            "a": "AWS는 서비스가 많고 문서가 자주 갱신되어 모델의 학습 시점 지식만으로는 옛 정보나 부정확한 사용법을 줄 수 있습니다. 이 MCP는 답변 시점에 공식 문서를 직접 조회해 근거 있는 답과 인용을 만들 수 있게 해 정확도를 높여줍니다."
          }
        ],
        "relatedIds": [
          "mcp-firecrawl",
          "mcp-tavily",
          "mcp-cloudflare-workers-bindings"
        ]
      }
    },
    {
      "id": "mcp-chrome-devtools",
      "type": "mcp",
      "name": "Chrome DevTools MCP",
      "description": "Chrome DevTools 팀 공식 MCP 서버. 실제 Chrome을 제어해 네트워크/콘솔 검사, 성능 트레이스, 입력 자동화 등 브라우저 디버깅을 수행한다.",
      "useWhen": "프론트엔드 동작을 실제 브라우저에서 검증하거나 성능/네트워크/콘솔을 디버깅할 때.",
      "tags": {
        "framework": [],
        "lang": [
          "node"
        ],
        "task": [
          "browser-automation",
          "debugging",
          "performance",
          "frontend"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add chrome-devtools -- npx chrome-devtools-mcp@latest",
        "env": []
      },
      "source_url": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
      "popularity": "Chrome DevTools 팀 공식 제공, 브라우저 디버깅 MCP의 대표격",
      "seo": {
        "seoTitle": "Chrome DevTools MCP — Claude로 실제 Chrome 디버깅·성능 트레이스",
        "metaDescription": "Chrome DevTools 팀 공식 MCP 서버. 실제 Chrome을 제어해 네트워크·콘솔 검사, 성능 트레이스, 입력 자동화, Lighthouse 감사를 AI 에이전트에서 수행한다. Node 기반 설치·보안 주의점 정리.",
        "summary": "Chrome DevTools MCP는 Chrome DevTools 팀이 공식으로 제공하는 MCP(Model Context Protocol) 서버로, AI 코딩 에이전트(Claude Code 등)가 실제로 구동 중인 Chrome 브라우저를 제어하고 검사할 수 있게 해 준다. 즉 LLM이 \"화면을 보지 못해 추측으로만 프런트엔드 버그를 다루는\" 한계를 풀어 준다. 에이전트가 직접 페이지를 열고, 네트워크 요청과 콘솔 메시지를 읽고(소스맵 기반 스택 트레이스 포함), 성능 트레이스를 기록하며, Lighthouse 감사와 메모리 힙 스냅샷까지 수행할 수 있다.\n\n핵심 기능은 크게 세 갈래다. (1) 입력 자동화: 클릭·타이핑·폼 입력·파일 업로드, 페이지 생성/이동/종료, 뷰포트 리사이즈와 디바이스 에뮬레이션. (2) 디버깅·분석: 스크린샷·스냅샷 캡처, 콘솔 메시지 검사, 네트워크 요청 모니터링, JavaScript를 브라우저 컨텍스트에서 직접 실행. (3) 성능: 퍼포먼스 트레이스 기록과 DevTools 기반 인사이트, CrUX(실사용자 경험) 데이터 연계. 실험적으로 스크린캐스트 녹화, Chrome 확장 관리 등도 지원한다.\n\n대상 브라우저는 Google Chrome(현재 안정 버전 이상)이며 Chrome for Testing이 공식 지원된다. 다른 Chromium 계열은 동작할 수 있으나 보장되지 않는다. Node.js LTS와 npm, 그리고 Chrome 설치가 전제다.\n\n프런트엔드 개발자, QA·E2E 자동화 담당자, 성능/접근성 회귀를 잡으려는 팀, 그리고 \"실제로 렌더된 결과를 보고 고쳐 달라\"고 에이전트에 시키고 싶은 사람에게 적합하다. 재현 가능한 버그 조사, 네트워크 실패 진단, Core Web Vitals 점검 같은 작업에서 특히 강하다. 정확한 도구 목록·옵션은 공식 문서 확인을 권장한다.",
        "whenToUse": "프런트엔드 버그를 \"실제 렌더 결과·네트워크·콘솔\"을 보고 고치게 하고 싶을 때, 성능 트레이스·Lighthouse로 Core Web Vitals나 회귀를 점검할 때, 폼 입력·클릭 같은 브라우저 동작을 자동화해 재현·검증할 때 적합하다. 추측 기반 디버깅 대신 에이전트가 직접 페이지를 열어 확인해야 하는 시나리오에 쓴다.",
        "installNotes": "Node.js LTS와 npm, 그리고 Google Chrome(현재 안정 버전 이상, Chrome for Testing 공식 지원)이 설치돼 있어야 한다. npx로 매번 최신 패키지를 받아 실행하는 형태라 첫 실행 시 다운로드가 발생한다. 다른 Chromium 계열은 동작이 보장되지 않는다. 사용 통계 수집은 기본 활성이며 플래그로 끌 수 있고 npm 업데이트 점검도 기본 동작한다. 정확한 옵션·플래그는 공식 문서 확인을 권장한다.",
        "securityNotes": "이 서버는 브라우저에 보이는 콘텐츠 전체를 MCP 클라이언트에 노출한다. 즉 에이전트가 현재 Chrome 세션에서 보이는 데이터(로그인 상태, 쿠키 기반 페이지, DevTools에 드러난 정보)를 읽고 수정할 수 있으므로, 민감한 계정이 로그인된 프로필로 붙이지 말고 격리된 프로파일/Chrome for Testing 사용을 권장한다. 임의 페이지를 열어 JavaScript를 실행하므로 신뢰할 수 없는 사이트의 콘솔·DOM 내용이 프롬프트 인젝션 경로가 될 수 있다. 사용 통계는 기본 수집(플래그로 비활성)되니 정책 확인 권장. 별도 API 키는 요구하지 않는다.",
        "faq": [
          {
            "q": "어떤 브라우저를 제어하나요?",
            "a": "Google Chrome(현재 안정 버전 이상)을 제어하며 Chrome for Testing이 공식 지원됩니다. 다른 Chromium 계열은 동작할 수 있으나 보장되지 않습니다. 별도 헤드리스 라이브러리가 아니라 실제 Chrome 인스턴스를 다룹니다."
          },
          {
            "q": "무엇을 할 수 있나요?",
            "a": "네트워크 요청·콘솔 메시지 검사, 성능 트레이스 기록, Lighthouse 감사, 스크린샷/스냅샷, 클릭·타이핑·폼 입력 등 입력 자동화, 브라우저 컨텍스트에서 JavaScript 실행, 메모리 힙 스냅샷 등을 수행합니다."
          },
          {
            "q": "설치에 무엇이 필요한가요?",
            "a": "Node.js LTS와 npm, 그리고 Chrome 설치가 필요합니다. API 키는 요구하지 않습니다. 민감 정보가 로그인된 프로필 대신 격리된 프로파일 사용을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-puppeteer-hisma",
          "mcp-browserbase",
          "mcp-hyperbrowser"
        ]
      }
    },
    {
      "id": "mcp-figma-dev-mode",
      "type": "mcp",
      "name": "Figma Dev Mode MCP (로컬)",
      "description": "Figma 공식 Dev Mode MCP 서버. Figma 데스크톱이 로컬에 띄우는 서버로 선택한 디자인의 코드/메타데이터/스크린샷/변수 정의를 가져온다(design-to-code).",
      "useWhen": "Figma 디자인을 코드로 구현하거나 디자인 토큰/컴포넌트 컨텍스트를 코드 작업에 끌어올 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "design",
          "design-to-code",
          "ui"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add --transport http figma-dev-mode http://127.0.0.1:3845/mcp",
        "env": []
      },
      "source_url": "https://help.figma.com/hc/en-us/articles/32132100833559-Guide-to-the-Figma-MCP-server",
      "popularity": "Figma 공식 기능, 디자인-투-코드 분야에서 사실상 표준",
      "seo": {
        "seoTitle": "Figma Dev Mode MCP (로컬) — Claude Code 디자인 투 코드 연동",
        "metaDescription": "Figma 공식 Dev Mode MCP 서버를 Claude Code에 연결해 선택한 디자인의 코드·메타데이터·스크린샷·변수 정의를 가져오는 design-to-code 워크플로우 설정 가이드.",
        "summary": "Figma Dev Mode MCP는 Figma가 공식 제공하는 로컬 MCP(Model Context Protocol) 서버입니다. Figma 데스크톱 앱이 실행 중일 때 로컬 호스트(예: 127.0.0.1:3845)에 서버를 띄우고, Claude Code 같은 MCP 클라이언트가 HTTP 트랜스포트로 접속해 현재 선택한 디자인의 정보를 구조화된 형태로 가져올 수 있게 합니다. 핵심 목적은 design-to-code, 즉 디자인을 코드로 옮기는 과정에서 사람이 화면을 눈으로 보고 수치를 옮겨 적던 작업을 줄이는 것입니다.\n\n이 서버를 통해 AI는 선택된 프레임·컴포넌트의 코드 표현(레이아웃·스타일 등), 노드 구조와 메타데이터, 화면 스크린샷, 그리고 디자인 변수(색상·간격·타이포 등 토큰) 정의를 조회할 수 있습니다. 덕분에 AI가 임의로 픽셀 값을 추측하는 대신 실제 디자인 소스의 변수와 측정값을 근거로 컴포넌트를 구현할 수 있어, 디자인 시스템과의 정합성을 높이고 반복 수정 비용을 줄이는 데 도움이 됩니다.\n\n쓰면 좋은 사람: Figma로 받은 시안을 React·Tailwind 등으로 구현하는 프런트엔드 개발자, 디자인 토큰을 코드 변수로 맞추려는 디자인 시스템 담당자, 시안 기반 UI 작업을 AI에게 맡기되 수치 오차를 줄이고 싶은 팀입니다. 특히 디자인 변수 정의를 직접 읽어오므로 색·간격·라운드 같은 축을 토큰으로 일관되게 박는 작업과 잘 맞습니다.\n\n전제 조건: 로컬 서버이므로 Figma 데스크톱 앱이 실행 중이어야 하고, Dev Mode MCP 서버 기능이 활성화돼 있어야 합니다. 사용 가능 여부·요금제 조건·정확한 포트와 활성화 절차는 버전에 따라 달라질 수 있으니 출처의 Figma 공식 문서(Guide to the Figma MCP server) 확인을 권장합니다.",
        "whenToUse": "Figma 시안을 코드로 옮길 때, 특히 AI에게 컴포넌트 구현을 맡기되 색·간격·타이포 등 디자인 변수와 측정값을 추측이 아니라 실제 소스에서 가져오게 하고 싶을 때 적합합니다. 디자인 시스템 토큰을 코드 변수와 맞추는 작업, 선택 프레임의 구조·스크린샷·메타데이터를 근거로 한 UI 구현 검토에 유용합니다. 디자인 변경이 잦아 반복 수정 비용이 큰 프런트엔드 팀에 특히 효과적입니다.",
        "installNotes": "로컬 전용 서버라 Figma 데스크톱 앱이 실행 중이어야 하며, 앱에서 Dev Mode MCP 서버 기능을 켜야 동작합니다. Claude Code는 HTTP 트랜스포트로 로컬 주소(예: 127.0.0.1:3845)에 접속합니다. 사용 가능 여부와 요금제 조건, 정확한 포트·활성화 절차는 Figma 버전과 정책에 따라 달라질 수 있으니 공식 문서 확인을 권장합니다. 연결이 안 되면 앱 실행 상태와 포트, 서버 활성화 여부를 먼저 점검하세요.",
        "securityNotes": "별도 API 키나 비밀키는 요구하지 않으며 로컬 호스트에 한정된 서버라 외부 노출 위험은 낮은 편입니다. 다만 AI가 현재 Figma 세션에서 선택한 디자인의 코드·메타데이터·스크린샷·변수 정의에 접근하므로, 미공개 제품 디자인이나 내부 자료가 AI 컨텍스트와 대화 로그로 전달될 수 있음을 인지해야 합니다. 디자인에 포함된 텍스트(레이어 이름·주석 등)가 프롬프트 인젝션 경로가 될 수 있으니 가져온 내용을 무비판적으로 명령으로 실행하지 마세요. 로컬 포트는 외부에 개방하지 말고, 민감 시안 작업 시 접근 범위를 확인하세요.",
        "faq": [
          {
            "q": "Figma 데스크톱 앱 없이도 쓸 수 있나요?",
            "a": "아니요. 로컬 Dev Mode MCP 서버는 Figma 데스크톱 앱이 실행되어 서버를 띄워야 동작합니다. 앱에서 해당 기능 활성화도 필요하며, 자세한 조건은 공식 문서 확인을 권장합니다."
          },
          {
            "q": "어떤 정보를 가져올 수 있나요?",
            "a": "선택한 디자인의 코드 표현, 노드 구조·메타데이터, 화면 스크린샷, 그리고 색·간격·타이포 등 디자인 변수(토큰) 정의를 조회할 수 있어 추측 없이 정합성 높은 design-to-code 구현이 가능합니다."
          },
          {
            "q": "API 키가 필요한가요?",
            "a": "이 설정은 로컬 HTTP 접속이라 별도 비밀키를 요구하지 않습니다. 다만 요금제·기능 가용성 조건이 있을 수 있으니 Figma 공식 문서를 확인하세요."
          }
        ],
        "relatedIds": [
          "frontend-design",
          "brand-guidelines",
          "canvas-design"
        ]
      }
    },
    {
      "id": "mcp-cloudflare-workers-bindings",
      "type": "mcp",
      "name": "Cloudflare Workers Bindings MCP",
      "description": "Cloudflare 공식 원격 MCP 서버. Workers, KV, R2, D1, Hyperdrive 등 Workers 플랫폼 리소스를 OAuth로 조회/생성/관리한다.",
      "useWhen": "Cloudflare Workers 스택(KV/R2/D1 등)을 AI로 관리하거나 풀스택 앱을 구성할 때.",
      "tags": {
        "framework": [
          "cloudflare-workers"
        ],
        "lang": [
          "node"
        ],
        "task": [
          "cloud",
          "edge",
          "infrastructure"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add --transport sse cloudflare-bindings https://bindings.mcp.cloudflare.com/sse",
        "env": []
      },
      "source_url": "https://github.com/cloudflare/mcp-server-cloudflare",
      "popularity": "Cloudflare 공식 13종 MCP 중 하나, OAuth 원격 서버로 널리 사용",
      "seo": {
        "seoTitle": "Cloudflare Workers Bindings MCP — Workers·KV·R2·D1 관리 MCP 서버",
        "metaDescription": "Cloudflare 공식 원격 MCP 서버. Claude에서 Workers·KV·R2·D1·Hyperdrive 등 엣지 리소스를 OAuth 인증으로 조회·생성·관리한다. SSE 트랜스포트로 연결하는 설치·보안 가이드.",
        "summary": "Cloudflare Workers Bindings MCP는 Cloudflare가 공식 제공하는 원격(remote) MCP 서버로, Claude Code 같은 MCP 클라이언트가 Cloudflare Workers 플랫폼의 리소스를 자연어 대화 안에서 직접 다루게 해준다. SSE 트랜스포트로 연결하며, 처음 연결할 때 브라우저 OAuth 인증을 거쳐 사용자의 Cloudflare 계정 권한 범위에서 동작한다.\n\n해결하는 문제는 명확하다. 평소 Workers·KV·R2·D1·Hyperdrive 같은 엣지 리소스를 다루려면 대시보드를 오가거나 Wrangler CLI 명령을 외워 입력해야 하는데, 이 MCP는 그 과정을 에이전트에게 위임한다. \"이 Worker에 연결된 KV 네임스페이스 뭐가 있지\", \"D1 데이터베이스 새로 만들어줘\", \"R2 버킷 목록 보여줘\" 같은 요청을 모델이 실제 API 호출로 옮겨 조회·생성·관리한다. 빌딩 블록(바인딩)을 다루는 데 특화돼 있어 Workers 앱의 스토리지·DB·캐시 구성을 빠르게 파악하고 셋업하기 좋다.\n\n핵심 기능은 (1) Workers 스크립트 및 설정 조회, (2) KV 네임스페이스, (3) R2 오브젝트 스토리지 버킷, (4) D1 서버리스 SQLite 데이터베이스, (5) Hyperdrive 연결 등 주요 바인딩 리소스의 열람과 관리다. Cloudflare는 이 외에도 Observability, Radar, Browser Rendering 등 여러 목적별 원격 MCP 서버를 분리 운영하므로, 바인딩 서버는 그중 \"Workers 리소스 운영\"에 초점을 둔 엔드포인트다.\n\n누가 쓰면 좋은가. Cloudflare Workers로 엣지 애플리케이션을 개발·운영하는 팀, 여러 환경의 바인딩 구성을 자주 점검해야 하는 인프라 담당자, AI 에이전트로 클라우드 셋업을 자동화하려는 개발자에게 적합하다. 다만 원격 서버 사양과 노출되는 도구 목록은 Cloudflare가 업데이트하므로, 정확한 지원 리소스·권한 범위는 공식 문서와 저장소(cloudflare/mcp-server-cloudflare) 확인을 권장한다.",
        "whenToUse": "Cloudflare Workers로 서비스를 운영하면서 KV·R2·D1·Hyperdrive 바인딩을 자주 조회·생성·점검해야 할 때, 대시보드나 Wrangler 명령을 일일이 거치지 않고 Claude 대화 안에서 처리하고 싶을 때 적합하다. 엣지 인프라 셋업을 AI 에이전트에게 위임해 반복 작업을 줄이려는 개발자·인프라 담당자에게 유용하다. 단, 프로덕션 리소스를 다루므로 권한 범위를 좁힌 별도 계정·환경에서 시작하는 것을 권한다.",
        "installNotes": "원격(remote) MCP 서버라 로컬에 패키지를 설치하지 않고 SSE 트랜스포트로 연결한다. 클라이언트에 등록한 뒤 첫 사용 시 브라우저가 열려 Cloudflare OAuth 동의를 거치며, 이때 로그인한 계정의 권한 범위가 그대로 적용된다. 여러 Cloudflare 계정·존(zone)을 쓴다면 의도한 계정으로 인증됐는지 확인한다. Cloudflare는 목적별로 여러 원격 MCP 서버를 분리 운영하므로, 바인딩 외 기능이 필요하면 별도 엔드포인트를 추가로 등록해야 한다. 지원 리소스·엔드포인트 변경 가능성이 있어 공식 문서 확인을 권장한다.",
        "securityNotes": "OAuth로 연결되는 사용자 Cloudflare 계정의 권한으로 동작하므로, 인증 계정이 가진 범위만큼 Workers·KV·R2·D1·Hyperdrive를 조회·생성·삭제할 수 있다. 프로덕션 데이터(스토리지 오브젝트, DB 레코드)에 접근·변경하거나 리소스를 잘못 삭제할 위험이 있으니, 가능하면 최소 권한 API 토큰/계정 또는 분리된 환경으로 시작하라. 별도 API 키를 평문으로 넣는 방식이 아니라 OAuth 토큰 기반이므로 토큰 저장 위치와 클라이언트 보안을 관리해야 한다. 또한 모델이 KV·R2·D1에 저장된 외부 콘텐츠를 읽어 들일 때 prompt injection으로 의도치 않은 명령을 수행할 가능성이 있으니, 파괴적 작업(삭제·덮어쓰기)은 사람 확인을 거치도록 운용한다.",
        "faq": [
          {
            "q": "별도 API 키를 발급해서 넣어야 하나요?",
            "a": "아니요. 이 서버는 원격 MCP 서버로, 첫 연결 시 브라우저 OAuth 인증을 거쳐 로그인한 Cloudflare 계정 권한으로 동작합니다. 환경변수로 평문 키를 넣는 방식이 아니므로, 인증에 쓰는 계정의 권한 범위를 적절히 제한하는 것이 중요합니다."
          },
          {
            "q": "어떤 Cloudflare 리소스를 다룰 수 있나요?",
            "a": "Workers와 그에 연결되는 바인딩 리소스인 KV 네임스페이스, R2 버킷, D1 데이터베이스, Hyperdrive 등을 조회·생성·관리하는 데 초점이 있습니다. 정확한 지원 도구 목록은 Cloudflare가 업데이트하므로 공식 저장소(cloudflare/mcp-server-cloudflare) 확인을 권장합니다."
          },
          {
            "q": "프로덕션 리소스를 잘못 삭제할 위험은 없나요?",
            "a": "인증 계정 권한 내에서는 생성뿐 아니라 삭제·변경도 가능하므로 위험이 존재합니다. 최소 권한 계정이나 분리된 환경에서 시작하고, 파괴적 작업은 사람이 확인하는 절차를 두는 것을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-netlify",
          "mcp-vercel",
          "mcp-aws-documentation"
        ]
      }
    },
    {
      "id": "mcp-netlify",
      "type": "mcp",
      "name": "Netlify MCP",
      "description": "Netlify 공식 MCP 서버. 사이트 생성/배포/관리, 환경변수·폼·함수 등 Netlify 플랫폼 작업을 AI가 수행한다.",
      "useWhen": "Netlify에 사이트를 배포·관리하거나 배포 설정/환경변수를 AI로 다룰 때.",
      "tags": {
        "framework": [],
        "lang": [
          "node"
        ],
        "task": [
          "deployment",
          "hosting",
          "jamstack"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add netlify -- npx -y @netlify/mcp",
        "env": [
          "NETLIFY_PERSONAL_ACCESS_TOKEN"
        ],
        "secrets": [
          "NETLIFY_PERSONAL_ACCESS_TOKEN"
        ]
      },
      "source_url": "https://github.com/netlify/netlify-mcp",
      "popularity": "Netlify 공식 제공(@netlify/mcp), 배포 자동화 MCP로 인기",
      "seo": {
        "seoTitle": "Netlify MCP - AI로 Netlify 사이트 배포·관리 자동화하기",
        "metaDescription": "Netlify 공식 MCP 서버로 Claude가 사이트 생성·배포·환경변수·폼·함수 등 Netlify 작업을 직접 수행합니다. Jamstack 호스팅 워크플로를 AI로 자동화하는 방법을 정리했습니다.",
        "summary": "Netlify MCP는 Netlify가 공식 제공하는 Model Context Protocol 서버로, Claude Code 같은 AI 에이전트가 Netlify 플랫폼 작업을 대화로 직접 수행하게 해줍니다. 핵심 목적은 \"대시보드를 직접 클릭하거나 CLI 명령을 일일이 외우지 않고도, 자연어 지시로 사이트를 생성·배포·관리하는 것\"입니다.\n\n주요 기능은 Netlify 플랫폼 전반에 걸칩니다. 새 사이트 생성과 배포 트리거, 배포 상태 확인, 환경변수(빌드/런타임) 조회·설정, Netlify Forms(폼 제출 데이터)와 Functions(서버리스 함수) 같은 플랫폼 리소스 관리 등 일상적인 운영 작업을 AI가 수행할 수 있습니다. 구체적으로 지원하는 도구 목록과 동작 범위는 버전에 따라 달라질 수 있으므로 공식 문서 확인을 권장합니다.\n\n이 MCP가 푸는 문제는 명확합니다. Jamstack/정적 사이트를 운영하다 보면 \"배포 상태 확인 → 환경변수 수정 → 재배포\" 같은 반복 작업이 잦은데, 컨텍스트를 코드 작업과 배포 도구 사이에서 오가며 전환해야 합니다. Netlify MCP를 붙이면 코드 편집과 배포·운영을 같은 AI 세션 안에서 이어서 처리할 수 있어 맥락 전환 비용이 줄어듭니다.\n\n누가 쓰면 좋은가: Netlify로 프런트엔드·정적 사이트·Jamstack 앱을 호스팅하는 개발자, Netlify Functions/Forms를 함께 쓰는 팀, 그리고 AI 에이전트에게 배포 파이프라인 일부를 위임하려는 사람에게 적합합니다. 설치는 npx로 Netlify 공식 패키지를 Claude의 MCP로 추가하고, 인증용 Personal Access Token을 환경변수로 제공하는 방식입니다. Node 환경이 필요합니다. 자세한 토큰 발급과 권한 범위는 Netlify 공식 GitHub 저장소와 문서를 참고하세요.",
        "whenToUse": "Netlify로 사이트를 호스팅하면서 AI에게 배포·운영을 맡기고 싶을 때 적합합니다. 코드 수정 후 같은 세션에서 배포를 트리거하고 상태를 확인하거나, 환경변수를 일괄 조회·수정하거나, Functions·Forms 같은 플랫폼 리소스를 점검할 때 유용합니다. Jamstack/정적 사이트 워크플로에서 대시보드와 CLI를 오가는 반복 작업을 줄이려는 개발자에게 권장합니다.",
        "installNotes": "npx로 Netlify 공식 MCP 패키지를 Claude의 MCP 서버로 추가하므로 Node.js 실행 환경이 필요합니다. 인증을 위해 환경변수 NETLIFY_PERSONAL_ACCESS_TOKEN에 Netlify Personal Access Token을 설정해야 하며, 토큰이 없으면 사이트·배포 관련 작업이 동작하지 않습니다. 토큰 발급 위치와 지원 도구 범위는 버전에 따라 달라질 수 있으니 Netlify 공식 GitHub 저장소·문서 확인을 권장합니다. 등록 후 Claude 재시작이 필요할 수 있습니다.",
        "securityNotes": "NETLIFY_PERSONAL_ACCESS_TOKEN은 계정의 사이트 생성·배포·설정 변경 권한을 가질 수 있는 민감 자격증명입니다. 토큰을 코드·로그·커밋에 노출하지 말고 환경변수나 비밀 관리로만 주입하며, .gitignore 등재를 확인하세요. 가능하면 권한·범위를 최소화하고 정기적으로 회전하는 것이 안전합니다. AI가 배포 트리거·환경변수 변경·리소스 삭제 같은 파괴적·과금 영향 작업을 수행할 수 있으므로, 자동 실행 전 확인 단계를 두는 것을 권장합니다. 또한 Netlify Forms 제출 데이터 등 외부에서 들어온 콘텐츠에는 프롬프트 인젝션 위험이 있으니 신뢰할 수 없는 텍스트를 그대로 명령으로 취급하지 않도록 주의하세요.",
        "faq": [
          {
            "q": "Netlify MCP를 쓰려면 무엇이 필요한가요?",
            "a": "Node.js 실행 환경과 Netlify Personal Access Token이 필요합니다. npx로 공식 패키지를 Claude의 MCP로 추가하고, NETLIFY_PERSONAL_ACCESS_TOKEN 환경변수에 토큰을 설정하면 사이트·배포 작업을 AI가 수행할 수 있습니다."
          },
          {
            "q": "AI가 실수로 사이트를 잘못 배포하거나 설정을 바꿀 수 있나요?",
            "a": "가능합니다. 토큰 권한 범위 내에서 배포 트리거·환경변수 변경 등 영향이 있는 작업을 수행할 수 있으므로, 파괴적 작업에는 확인 단계를 두고 토큰 권한을 최소화하는 것을 권장합니다."
          },
          {
            "q": "Vercel MCP와 무엇이 다른가요?",
            "a": "둘 다 호스팅 플랫폼의 공식 MCP지만 대상 플랫폼이 다릅니다. Netlify MCP는 Netlify의 사이트·배포·Forms·Functions를, Vercel MCP는 Vercel 플랫폼 작업을 다룹니다. 사용 중인 호스팅에 맞는 것을 선택하세요."
          }
        ],
        "relatedIds": [
          "mcp-vercel",
          "mcp-cloudflare-workers-bindings",
          "mcp-git"
        ]
      }
    },
    {
      "id": "mcp-vercel",
      "type": "mcp",
      "name": "Vercel MCP",
      "description": "Vercel 공식 원격 MCP 서버. 프로젝트/배포 관리, 배포 로그 분석, Vercel 문서 검색을 OAuth로 안전하게 제공한다.",
      "useWhen": "Vercel 프로젝트/배포를 조회·관리하거나 배포 로그로 실패 원인을 분석할 때.",
      "tags": {
        "framework": [
          "nextjs"
        ],
        "lang": [
          "node"
        ],
        "task": [
          "deployment",
          "hosting",
          "monitoring"
        ]
      },
      "install": {
        "method": "command",
        "command": "claude mcp add --transport http vercel https://mcp.vercel.com",
        "env": []
      },
      "source_url": "https://vercel.com/docs/agent-resources/vercel-mcp",
      "popularity": "Vercel 공식 원격 MCP(2025 퍼블릭 베타), Claude/주요 AI 툴 연동 지원",
      "seo": {
        "seoTitle": "Vercel MCP 서버 — Claude Code로 배포·로그·문서 관리 (OAuth)",
        "metaDescription": "Vercel 공식 원격 MCP 서버를 Claude Code에 연결해 프로젝트·배포 관리, 배포 로그 분석, Vercel 문서 검색을 OAuth로 안전하게 수행하는 방법과 설치·보안 주의점을 정리했습니다.",
        "summary": "Vercel MCP는 Vercel이 공식 제공하는 원격(HTTP transport) MCP 서버로, Claude Code 같은 MCP 클라이언트가 Vercel 계정의 작업을 자연어로 다룰 수 있게 해줍니다. 핵심 기능은 세 가지로 요약됩니다. 첫째, 프로젝트와 배포 관리 — 어떤 프로젝트가 있는지, 최근 배포 상태가 무엇인지 조회하고 배포 흐름을 확인합니다. 둘째, 배포 로그 분석 — 실패하거나 이상이 있는 배포의 로그를 가져와 원인을 추적하고 디버깅을 돕습니다. 셋째, Vercel 공식 문서 검색 — 빌드 설정, 환경 변수, 도메인, 프레임워크 연동 등 문서를 검색해 정확한 근거와 함께 답을 얻습니다. 인증은 OAuth 기반이라 토큰을 코드나 설정 파일에 하드코딩하지 않고 브라우저 인증 흐름으로 안전하게 권한을 위임합니다.\\n\\n이 서버가 푸는 문제는 명확합니다. 평소 대시보드를 오가거나 CLI 명령을 일일이 외우지 않고도, AI 에이전트가 배포 상태·로그·문서를 한 흐름에서 조회해 \\\"왜 빌드가 깨졌는지\\\", \\\"어떤 환경 변수를 설정해야 하는지\\\"를 맥락과 함께 설명하게 만드는 것입니다. 특히 Next.js를 Vercel에 올려 운영하는 팀이라면, 코드 작업과 배포 점검을 같은 대화 안에서 이어가며 컨텍스트 전환 비용을 줄일 수 있습니다.\\n\\n쓰면 좋은 사람: Vercel에 프로젝트를 호스팅하는 Next.js/Node 개발자, 배포 실패 원인을 빠르게 좁히고 싶은 운영자, AI 에이전트로 배포 모니터링과 문서 확인을 자동화하려는 팀입니다. 실제 가능한 동작·권한 범위와 지원하는 도구 목록은 버전에 따라 달라질 수 있으니, 세부 사항은 Vercel 공식 문서(agent-resources/vercel-mcp)를 확인하는 것을 권장합니다.",
        "whenToUse": "Vercel에 호스팅하는 프로젝트의 배포 상태·로그를 AI 대화 안에서 바로 확인하고 싶을 때, 빌드/배포 실패 원인을 로그로 추적할 때, Vercel 문서를 근거로 환경 변수·도메인·프레임워크 설정을 점검할 때 적합합니다. 특히 Next.js를 Vercel에서 운영하며 코드 작업과 배포 모니터링을 한 흐름으로 묶고 싶은 개발자/운영자에게 유용합니다.",
        "installNotes": "원격(HTTP transport) 서버라 별도 패키지 설치 없이 클라이언트가 원격 엔드포인트에 연결합니다. 최초 연결 시 OAuth 브라우저 인증으로 Vercel 계정 권한을 위임해야 하므로 로그인 가능한 환경이 필요합니다. 접근 가능한 프로젝트는 인증한 계정/팀 권한 범위를 따릅니다. 도구 목록·지원 동작·엔드포인트는 버전에 따라 변경될 수 있으니 Vercel 공식 문서(agent-resources/vercel-mcp)를 확인하세요. 헤드리스 환경에서는 OAuth 콜백 처리가 까다로울 수 있습니다.",
        "securityNotes": "OAuth로 Vercel 계정 권한을 위임하므로, 인증한 계정/팀 범위의 프로젝트·배포·로그에 접근할 수 있습니다. 최소 권한 원칙으로 필요한 팀/프로젝트에만 권한을 부여하고, 운영 중요 계정과 분리하는 것이 안전합니다. 배포 로그에는 환경 변수 값·시크릿·내부 URL이 노출될 수 있으니 AI가 가져온 로그를 외부로 공유하거나 그대로 커밋하지 않도록 주의하세요. 로그·문서 등 외부 콘텐츠가 프롬프트로 유입되면 프롬프트 인젝션 위험이 있으므로, 자연어 지시를 무비판 실행하지 말고 파괴적/결제성 동작은 사람이 검토·승인하세요. 토큰은 설정 파일에 하드코딩하지 마세요(env 불필요: []).",
        "faq": [
          {
            "q": "별도 API 키나 토큰을 설정해야 하나요?",
            "a": "아니요. OAuth 기반 원격 서버라 env에 키를 넣지 않습니다(env: []). 최초 연결 시 브라우저 OAuth로 Vercel 계정 권한을 위임하며, 토큰을 설정 파일에 하드코딩하지 않습니다."
          },
          {
            "q": "무엇을 할 수 있나요?",
            "a": "프로젝트·배포 조회 및 관리, 배포 로그 분석을 통한 실패 원인 추적, Vercel 공식 문서 검색을 지원합니다. 구체적인 도구·동작 범위는 버전에 따라 다를 수 있어 공식 문서 확인을 권장합니다."
          },
          {
            "q": "접근할 수 있는 프로젝트 범위는 어떻게 정해지나요?",
            "a": "OAuth로 인증한 계정과 팀의 권한 범위를 따릅니다. 최소 권한 원칙으로 필요한 팀/프로젝트에만 권한을 부여하는 것이 안전합니다."
          }
        ],
        "relatedIds": [
          "mcp-netlify",
          "mcp-cloudflare-workers-bindings",
          "mcp-sentry"
        ]
      }
    },
    {
      "id": "pdf",
      "type": "skill",
      "name": "pdf",
      "description": "PDF 문서를 다루는 Anthropic 공식 스킬. 텍스트 추출, 병합/분할, 페이지 회전, 워터마크, 폼 필드 채우기, 암호화/복호화 등 PDF 전체 라이프사이클을 처리한다.",
      "useWhen": "PDF에서 데이터를 추출하거나, 여러 PDF를 병합/분할하거나, 폼을 채우거나, 워터마크/암호화 작업이 필요할 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "pdf",
          "document-processing",
          "extraction"
        ]
      },
      "install": {
        "method": "command",
        "command": "/plugin marketplace add anthropics/skills 후 /plugin install document-skills@anthropic-agent-skills",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/pdf",
      "popularity": "Anthropic 공식 reference skill (anthropics/skills repo, document-skills 플러그인에 포함), 매우 널리 쓰임",
      "seo": {
        "seoTitle": "pdf 스킬 — Claude Code PDF 처리(추출·병합·폼·암호화) 공식 스킬",
        "metaDescription": "Anthropic 공식 Claude Code 스킬 pdf. 텍스트 추출, 병합·분할, 페이지 회전, 워터마크, 폼 필드 채우기, 암호화·복호화까지 PDF 전체 라이프사이클을 다룬다. 설치·활용·보안 주의점 정리.",
        "summary": "pdf는 Anthropic이 공식 배포하는 Claude Code용 문서 처리 스킬(document-skills 묶음의 일부)로, PDF 파일을 읽고 가공하는 전체 라이프사이클을 에이전트가 직접 수행하도록 돕는다. 핵심 기능은 PDF에서 텍스트 추출, 여러 PDF의 병합과 분할, 페이지 회전, 워터마크 삽입, 폼(입력 양식) 필드 채우기, 그리고 암호화·복호화다. 즉 \"스캔본/계약서에서 본문만 뽑아오기\", \"여러 보고서를 한 파일로 합치기\", \"특정 페이지 범위만 잘라내기\", \"정해진 양식에 값 채워 제출용 PDF 만들기\"처럼 사람이 GUI 도구로 하던 반복 작업을 자연어 지시로 처리할 수 있게 한다.\n\n이 스킬은 별도의 외부 SaaS나 클라우드 변환 서비스에 의존하지 않고, 스킬에 포함된 스크립트와 참조 문서(SKILL.md·reference.md·forms.md 등)를 통해 로컬에서 작업을 안내·실행하는 구조다. 따라서 문서가 외부 서버로 전송되지 않는 로컬 처리를 기본으로 한다는 점이 데이터 민감도가 높은 문서를 다룰 때 장점이 된다. 폼 채우기와 암호화 같은 고급 동작은 forms.md·reference.md에 정리된 절차를 따른다.\n\n누가 쓰면 좋은가: 계약서·인보이스·리포트 등 대량의 PDF를 다루는 운영/백오피스 작업자, 문서 파이프라인을 자동화하려는 개발자, 제출용 양식을 반복 생성해야 하는 팀에 적합하다. 같은 document-skills 묶음의 docx·xlsx·pptx와 함께 쓰면 오피스 문서 전반을 하나의 워크플로로 묶을 수 있다. 정확한 함수·옵션·의존성은 버전에 따라 달라질 수 있으니 설치 후 스킬에 동봉된 공식 문서(SKILL.md/reference.md) 확인을 권장한다.",
        "whenToUse": "PDF에서 본문 텍스트를 뽑아 분석·요약·검색하려 할 때, 여러 PDF를 병합하거나 특정 페이지만 분할·회전하려 할 때, 워터마크를 넣거나 제출용 양식(폼 필드)을 자동으로 채워야 할 때, PDF에 암호를 걸거나 풀어야 할 때 적합하다. 반복적인 문서 가공을 자연어 지시로 자동화하고 싶고, 문서를 외부 서비스에 올리지 않고 로컬에서 처리하고 싶은 경우에 특히 유용하다.",
        "installNotes": "Claude Code의 플러그인 마켓플레이스를 통해 document-skills 묶음으로 설치되며(설치 명령은 별도 표시), pdf 단독이 아니라 docx·xlsx·pptx와 함께 들어온다. 설치 후 스킬에 동봉된 스크립트가 의존하는 런타임·라이브러리가 로컬에 갖춰져 있어야 일부 동작(폼 채우기·암호화 등)이 정상 실행된다. 정확한 사용법·함수·옵션은 버전에 따라 달라질 수 있으므로 스킬 폴더의 SKILL.md·reference.md·forms.md 공식 문서 확인을 권장한다.",
        "securityNotes": "API 키나 비밀키는 필요하지 않다. 다만 계약서·신분 정보 등 민감한 PDF를 다룰 가능성이 높으므로 처리 대상 파일의 접근 범위에 주의해야 한다. 암호화·복호화 시 사용하는 비밀번호가 명령 기록이나 로그에 평문으로 남지 않도록 관리하고, 복호화는 권한 있는 문서에만 수행한다. 병합·분할·덮어쓰기는 원본 파일을 변경·손실시킬 수 있으니 사본으로 작업하길 권장한다. 또한 PDF 본문·폼 텍스트에 삽입된 지시문이 프롬프트 인젝션으로 작동할 수 있으므로, 추출된 내용을 그대로 신뢰해 실행하지 말고 신뢰 경계를 둘 것.",
        "faq": [
          {
            "q": "pdf 스킬만 따로 설치할 수 있나요?",
            "a": "마켓플레이스를 통해 document-skills 묶음으로 설치되며, pdf는 docx·xlsx·pptx와 함께 들어옵니다. 사용할 때는 PDF 작업에 한해 pdf 스킬이 동작합니다. 정확한 구성은 설치 후 공식 문서 확인을 권장합니다."
          },
          {
            "q": "문서가 외부 서버로 전송되나요?",
            "a": "이 스킬은 외부 SaaS 변환 서비스에 의존하지 않고 동봉 스크립트로 로컬 처리를 안내·실행하는 구조라, 기본적으로 PDF가 외부로 전송되지 않습니다. 다만 사용하는 다른 도구·환경 설정에 따라 달라질 수 있으니 민감 문서는 처리 경로를 확인하세요."
          },
          {
            "q": "폼 필드 채우기나 암호화도 되나요?",
            "a": "네. 폼(입력 양식) 필드 채우기, 워터마크, 암호화·복호화까지 지원합니다. 폼 관련 세부 절차는 forms.md, 전체 기능·옵션은 reference.md에 정리되어 있으니 해당 문서를 참고하세요."
          }
        ],
        "relatedIds": [
          "docx",
          "xlsx",
          "pptx"
        ]
      }
    },
    {
      "id": "docx",
      "type": "skill",
      "name": "docx",
      "description": "Word(.docx) 문서를 ZIP/XML 구조로 다루는 Anthropic 공식 스킬. 목차, 머리글/바닥글, 이미지 삽입, 변경 내용 추적(tracked changes), 찾기-바꾸기 등을 지원한다.",
      "useWhen": "Word 문서를 생성하거나 기존 .docx를 편집(서식 유지, tracked changes, 표/이미지 삽입)해야 할 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "docx",
          "word",
          "document-processing"
        ]
      },
      "install": {
        "method": "command",
        "command": "/plugin marketplace add anthropics/skills 후 /plugin install document-skills@anthropic-agent-skills",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/docx",
      "popularity": "Anthropic 공식 reference skill (document-skills 플러그인), Claude의 문서 생성 기능을 구동하는 핵심 스킬",
      "seo": {
        "seoTitle": "docx 스킬: Claude로 Word(.docx) 문서 자동 생성·편집·변경추적",
        "metaDescription": "Anthropic 공식 docx 스킬로 Word 문서를 코드처럼 다루세요. 목차·머리글/바닥글·이미지 삽입, 찾기-바꾸기, 변경 내용 추적(tracked changes)까지 Claude가 자동 처리합니다.",
        "summary": "docx는 Anthropic이 공식 배포하는 Claude Code용 문서 처리 스킬로, Microsoft Word(.docx) 파일을 ZIP/XML 구조 수준에서 직접 다룰 수 있게 해줍니다. .docx는 사실상 여러 XML 파트(document.xml, styles.xml, header/footer 등)와 미디어 리소스가 묶인 ZIP 컨테이너인데, 이 스킬은 그 내부 구조를 이해하고 안전하게 조작하는 방법과 도구 사용법을 Claude에게 제공합니다. 덕분에 사람이 워드를 열어 수작업하던 반복 편집을 자연어 지시만으로 자동화할 수 있습니다.\n\n핵심으로 지원하는 작업은 다음과 같습니다. (1) 목차(TOC) 생성·갱신, (2) 머리글/바닥글 추가·수정, (3) 본문 내 이미지 삽입, (4) 문서 전체를 대상으로 한 찾기-바꾸기, (5) 변경 내용 추적(tracked changes) 형태의 수정 — 즉 검토자가 워드에서 \"변경 내용 검토\"로 보고 수락/거절할 수 있는 마크업으로 편집을 남기는 기능입니다. 단순 텍스트 치환을 넘어 스타일·서식·문서 구조를 보존하면서 편집한다는 점이 일반 텍스트 변환과의 차이입니다.\n\n이런 작업이 잘 맞는 사용자는: 계약서·보고서·제안서 같은 표준 양식을 대량으로 채워야 하는 실무자, 템플릿 기반으로 여러 문서를 생성하는 운영/법무/HR 담당자, 리뷰 코멘트나 수정 제안을 tracked changes로 일괄 반영해야 하는 편집자, 그리고 문서 파이프라인을 자동화하려는 개발자입니다. 워드 문서를 사람이 열지 않고도 생성·수정·검토용으로 가공해야 할 때 특히 유용합니다.\n\n이 스킬은 별도 외부 SaaS API 키 없이 로컬에서 .docx 파일을 다루는 흐름을 전제로 하며, pdf·xlsx·pptx 등 다른 오피스 문서 스킬과 함께 \"문서 스킬\" 묶음으로 제공됩니다. 세부 동작과 한계는 출처 저장소의 공식 문서를 함께 확인하는 것을 권장합니다.",
        "whenToUse": "Word(.docx) 문서를 사람이 직접 열지 않고 자동으로 생성·수정·검토 가공해야 할 때 적합합니다. 예: 템플릿에 데이터를 채워 계약서/보고서/제안서를 대량 생성, 머리글·바닥글·목차 일괄 정비, 여러 문서에 동일한 찾기-바꾸기 적용, 리뷰 수정안을 변경 내용 추적(tracked changes)으로 남겨 검토자가 수락/거절하게 하기. 서식·스타일을 보존해야 하는 워드 편집 자동화 전반에 유용합니다.",
        "installNotes": "Anthropic 공식 스킬 마켓플레이스를 통해 설치하며, document-skills 플러그인에 pdf·xlsx·pptx와 함께 묶여 제공됩니다(설치 명령은 별도 표기). 로컬에서 .docx 파일을 ZIP/XML로 다루는 흐름이라 외부 SaaS API 키는 필요 없습니다. 다만 .docx 내부 XML을 직접 조작하므로 원본 파일은 반드시 백업하고, 결과는 실제 Word나 호환 뷰어에서 서식·목차·변경 내용 추적 표시가 의도대로 보이는지 검증하세요. 매크로(.docm), 복잡한 표/수식 등 일부 구조는 한계가 있을 수 있어 공식 문서 확인을 권장합니다.",
        "securityNotes": "이 스킬은 별도 비밀키나 외부 인증을 요구하지 않지만, 로컬 파일시스템의 .docx를 읽고 덮어씁니다. 따라서 처리 대상 폴더 접근 권한이 곧 데이터 접근 범위가 되며, 계약서·인사·재무 같은 민감 문서를 다룰 때 유출·과다 노출에 주의해야 합니다. 찾기-바꾸기·변경 내용 추적은 원본을 직접 수정하므로 잘못된 패턴이 다수 파일을 손상시킬 수 있어 백업과 결과 검증이 필수입니다. 또한 외부에서 받은 .docx에는 머리글/주석/숨김 텍스트 등에 악의적 지시(프롬프트 인젝션)나 추적용 메타데이터가 포함될 수 있으니, 신뢰할 수 없는 문서 내용을 그대로 실행 지시로 받아들이지 말고 검토 후 처리하세요.",
        "faq": [
          {
            "q": "docx 스킬로 변경 내용 추적(tracked changes)을 남길 수 있나요?",
            "a": "네. 워드의 '변경 내용 검토'에서 수락/거절할 수 있는 tracked changes 형태로 편집을 남기는 것을 지원합니다. 검토자가 어떤 수정이 가해졌는지 확인하고 선택적으로 반영할 수 있어, 편집·리뷰 워크플로에 유용합니다."
          },
          {
            "q": "외부 API 키나 유료 서비스 가입이 필요한가요?",
            "a": "아니요. .docx를 ZIP/XML 구조로 로컬에서 직접 다루는 방식이라 별도의 외부 SaaS API 키는 필요하지 않습니다. 다만 로컬 파일을 읽고 덮어쓰므로 파일 접근 권한과 백업에 유의하세요."
          },
          {
            "q": "PDF나 엑셀, 파워포인트도 같은 방식으로 다룰 수 있나요?",
            "a": "docx는 Word 전용입니다. 동일한 Anthropic 문서 스킬 묶음에 pdf, xlsx(엑셀), pptx(파워포인트) 스킬이 함께 제공되므로 형식에 맞는 스킬을 사용하세요. 자세한 기능과 한계는 공식 문서 확인을 권장합니다."
          }
        ],
        "relatedIds": [
          "pdf",
          "xlsx",
          "pptx"
        ]
      }
    },
    {
      "id": "xlsx",
      "type": "skill",
      "name": "xlsx",
      "description": "Excel(.xlsx) 스프레드시트를 다루는 Anthropic 공식 스킬. 수식 오류 없는 생성, 차트, 조건부 서식, 피벗 테이블 등을 지원한다.",
      "useWhen": "엑셀 스프레드시트를 생성/편집하거나 수식·차트·피벗 테이블이 포함된 데이터 작업이 필요할 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "xlsx",
          "excel",
          "spreadsheet",
          "data-analysis"
        ]
      },
      "install": {
        "method": "command",
        "command": "/plugin marketplace add anthropics/skills 후 /plugin install document-skills@anthropic-agent-skills",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/xlsx",
      "popularity": "Anthropic 공식 reference skill (document-skills 플러그인), 데이터/스프레드시트 작업에 널리 쓰임",
      "seo": {
        "seoTitle": "xlsx 스킬: Claude Code로 수식 오류 없는 Excel 자동 생성·편집",
        "metaDescription": "Anthropic 공식 xlsx 스킬은 Claude Code에서 .xlsx 스프레드시트를 생성·편집·분석한다. pandas·openpyxl 기반으로 수식, 차트, 서식, 데이터 정리를 다루고 LibreOffice 재계산으로 수식 오류 0을 보장한다.",
        "summary": "xlsx는 Claude Code가 Excel 스프레드시트(.xlsx, .xlsm, .csv, .tsv)를 직접 다루도록 하는 Anthropic 공식 문서 스킬(document-skills 묶음)이다. \"스프레드시트 파일이 주된 입력 또는 출력일 때\" 발동하며, 기존 시트를 열어 읽고 수정·보정하거나 새 시트를 처음부터 만들고 표 형식 간 변환을 수행한다.\n\n핵심은 단순 값 채우기가 아니라 동적 스프레드시트 유지다. 하드코딩된 값 대신 실제 Excel 수식을 넣어 입력값이 바뀌면 결과가 따라 갱신되게 하고, 재무 모델 관례(입력=파랑, 수식=검정, 시트 내 링크=초록, 외부 링크=빨강)와 숫자 서식(연도는 텍스트, 통화는 단위 표기, 백분율 0.0%)을 적용한다. 하드코딩 값에는 출처와 날짜를 기록하도록 요구한다.\n\n작업에는 두 라이브러리를 쓴다. pandas는 데이터 분석·대량 처리·집계에, openpyxl은 복잡한 서식·수식·Excel 고유 기능에 사용한다. 또한 LibreOffice를 이용한 자동 재계산(scripts/recalc.py)으로 산출물을 검증해 #REF!, #DIV/0!, #VALUE!, #N/A, #NAME? 같은 수식 오류가 0인 상태로 결과를 내보내며, 오류가 있으면 위치를 담은 JSON 리포트를 돌려준다. 열 추가, 수식 계산, 조건부 서식, 깨진 행·잘못된 헤더·잡데이터 정리 같은 작업도 처리한다.\n\n데이터 분석가, 재무 모델 담당자, 리포트를 반복 생성하는 운영 담당자, 지저분한 CSV를 정돈된 Excel로 바꿔야 하는 사람에게 적합하다. 차트·피벗 등 세부 동작과 최신 지원 범위는 공식 SKILL.md 확인을 권장한다.",
        "whenToUse": "스프레드시트 자체가 최종 산출물일 때 쓴다. 수식이 살아있는 재무·예측 모델을 만들거나, 기존 .xlsx를 열어 열 추가·수식 보정·서식 적용을 하거나, 지저분한 CSV/표 데이터를 정돈된 Excel로 변환할 때 유용하다. 수식 오류 없는 결과와 일관된 숫자·색 서식이 필요한 반복 리포트 작업에 특히 맞다. 반대로 산출물이 Word·HTML·DB·Google Sheets면 다른 스킬을 고려한다.",
        "installNotes": "Anthropic skills 마켓플레이스를 추가한 뒤 document-skills 플러그인을 설치하면 함께 제공된다(pdf·docx·pptx 등과 묶음). 별도 API 키는 필요 없다. 다만 데이터 처리에 pandas·openpyxl이, 수식 재계산에는 LibreOffice가 필요하며 LibreOffice는 첫 실행 시 자동 구성된다고 안내된다 — 환경에 미설치 시 재계산·오류검증 단계가 동작하지 않을 수 있으니 사전 설치 여부를 확인하라. 정확한 의존성·발동 조건은 공식 SKILL.md 확인 권장.",
        "securityNotes": "외부 네트워크 호출이나 API 키·비밀키가 필요 없는 로컬 파일 처리 스킬이라 자격증명 유출 위험은 낮다. 다만 로컬 파일 시스템에서 스프레드시트를 읽고 쓰며 기존 파일을 덮어쓸 수 있으므로, 중요한 원본은 백업 후 작업하라. 신뢰할 수 없는 출처의 시트에는 수식·외부 링크·매크로(.xlsm)가 포함될 수 있어 의도치 않은 데이터 참조나 외부 링크 평가가 일어날 수 있다 — 내용을 검토하고 필요 시 매크로를 비활성화하라. 민감·개인정보가 든 시트를 다룰 때는 산출물 공유 범위에 주의한다.",
        "faq": [
          {
            "q": "수식이 깨진 채로 결과가 나오나요?",
            "a": "아니요. 이 스킬은 LibreOffice 기반 자동 재계산(scripts/recalc.py)으로 산출물을 검증해 #REF!, #DIV/0!, #VALUE!, #N/A, #NAME? 같은 수식 오류가 0인 상태로 내보내는 것을 목표로 합니다. 오류가 발견되면 위치가 담긴 JSON 리포트를 돌려줍니다."
          },
          {
            "q": "값을 그냥 채우지 않고 수식으로 넣나요?",
            "a": "네. 하드코딩된 값 대신 실제 Excel 수식을 사용해 입력이 바뀌면 결과가 자동으로 갱신되는 동적 시트를 지향합니다. 재무 모델 색 규칙(입력 파랑, 수식 검정, 내부 링크 초록, 외부 링크 빨강)과 표준 숫자 서식도 적용합니다."
          },
          {
            "q": "CSV나 지저분한 데이터도 정리해 주나요?",
            "a": "네. .csv/.tsv를 포함한 표 형식 간 변환을 지원하고, 깨진 행·잘못 놓인 헤더·잡데이터 같은 지저분한 데이터를 정리하는 작업도 처리합니다. pandas로 대량 처리, openpyxl로 서식·수식 작업을 수행합니다."
          }
        ],
        "relatedIds": [
          "docx",
          "pptx",
          "pdf"
        ]
      }
    },
    {
      "id": "pptx",
      "type": "skill",
      "name": "pptx",
      "description": "PowerPoint(.pptx) 프레젠테이션을 다루는 Anthropic 공식 스킬. 템플릿 기반 및 처음부터 생성, 마스터 레이아웃, 발표자 노트, 코멘트를 지원한다.",
      "useWhen": "파워포인트 슬라이드 덱을 생성하거나 기존 .pptx를 편집(레이아웃, 발표자 노트)해야 할 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "pptx",
          "powerpoint",
          "presentation",
          "document-processing"
        ]
      },
      "install": {
        "method": "command",
        "command": "/plugin marketplace add anthropics/skills 후 /plugin install document-skills@anthropic-agent-skills",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/pptx",
      "popularity": "Anthropic 공식 reference skill (document-skills 플러그인), 프레젠테이션 생성에 널리 쓰임",
      "seo": {
        "seoTitle": "pptx 스킬: Claude로 PowerPoint(.pptx) 프레젠테이션 생성·편집",
        "metaDescription": "Anthropic 공식 pptx 스킬로 Claude Code에서 PowerPoint(.pptx)를 템플릿 기반·처음부터 생성하고 마스터 레이아웃, 발표자 노트, 코멘트까지 다루는 방법을 정리합니다.",
        "summary": "pptx는 Anthropic이 공식 배포하는 document-skills 묶음에 포함된 Claude Code용 스킬로, PowerPoint(.pptx) 프레젠테이션을 코드로 생성하고 편집할 수 있게 해줍니다. 자연어로 슬라이드 구성을 지시하면 Claude가 표지·목차·본문·차트·표·도형이 들어간 발표 자료를 만들어 주거나, 이미 있는 .pptx 파일을 열어 텍스트·이미지·레이아웃을 수정합니다.\n\n핵심 기능은 크게 두 갈래입니다. 첫째, 처음부터 생성(create from scratch)으로, 빈 상태에서 새 슬라이드 덱을 구성합니다. 둘째, 템플릿 기반 생성으로, 회사·팀이 정한 기존 .pptx 템플릿이나 슬라이드 마스터 레이아웃을 재사용해 브랜드 일관성을 유지한 채 내용만 채웁니다. 여기에 마스터 레이아웃(슬라이드 마스터), 발표자 노트(speaker notes), 코멘트(comments) 같은 PowerPoint 고유 요소를 다루는 워크플로가 포함되어, 단순 텍스트 나열을 넘어 실제 발표·리뷰 흐름에 맞는 문서를 만들 수 있습니다.\n\n스킬 내부 문서는 신규 생성용 라이브러리(PptxGenJS) 안내와 기존 파일 편집(editing) 안내를 구분해 제공하므로, \"새로 만들기\"와 \"기존 덱 손보기\"를 상황에 맞게 처리합니다. 스킬은 SKILL.md를 통해 Claude에게 작업 절차와 도구 사용법을 지시하는 방식으로 동작합니다.\n\n누가 쓰면 좋은가: 보고서·제안서·세미나 발표 자료를 반복 제작하는 기획자, 데이터를 슬라이드로 옮겨야 하는 분석가, 사내 템플릿을 지켜 대량의 덱을 찍어내야 하는 팀, 그리고 문서 자동화 파이프라인을 만드는 개발자에게 적합합니다. PDF·Word·Excel을 다루는 자매 스킬(pdf/docx/xlsx)과 함께 쓰면 문서 워크플로 전반을 Claude로 자동화할 수 있습니다. 세부 동작·옵션은 공식 문서 확인을 권장합니다.",
        "whenToUse": "발표 자료(.pptx)를 자연어 지시로 빠르게 만들거나, 사내 템플릿·슬라이드 마스터를 지켜 다량의 덱을 일관되게 찍어내야 할 때 유용합니다. 기존 PowerPoint 파일의 텍스트·이미지·레이아웃을 일괄 수정하거나, 발표자 노트·코멘트를 프로그램적으로 넣고 빼야 하는 작업, 데이터·문서를 슬라이드로 변환하는 자동화 파이프라인을 구축할 때도 적합합니다.",
        "installNotes": "document-skills 플러그인 묶음(pdf·docx·xlsx·pptx)에 포함되어 함께 설치됩니다. 마켓플레이스를 먼저 추가한 뒤 플러그인을 설치하는 2단계 절차이며, 설치 후 Claude Code 재시작 또는 스킬 목록 갱신이 필요할 수 있습니다. .pptx 생성·편집은 별도 라이브러리(PptxGenJS 등)와 실행 환경에 의존하므로, 스킬이 안내하는 의존성이 충족돼야 정상 동작합니다. 외부 API 키는 요구하지 않으며, 정확한 의존성·버전은 공식 문서 확인을 권장합니다.",
        "securityNotes": "외부 API 키나 비밀키를 요구하지 않습니다(env 없음). 다만 생성·편집 과정에서 로컬 파일시스템에 접근해 .pptx 파일을 읽고 쓰며, 코드/스크립트를 실행하므로 작업 디렉터리와 입력 파일 출처를 신뢰할 수 있어야 합니다. 신뢰할 수 없는 외부 .pptx를 편집 입력으로 받으면 그 안의 텍스트·노트·코멘트가 프롬프트 인젝션 통로가 될 수 있으니 주의하세요. 민감 정보가 담긴 슬라이드(고객 데이터, 내부 지표)를 다룰 때는 결과물 공유·커밋 범위를 점검하고, 기존 파일을 덮어쓰는 편집은 사본으로 작업해 원본 손실을 예방하세요.",
        "faq": [
          {
            "q": "pptx 스킬은 새 프레젠테이션만 만들 수 있나요, 기존 파일도 편집되나요?",
            "a": "둘 다 가능합니다. 빈 상태에서 처음부터 슬라이드 덱을 생성할 수 있고, 이미 있는 .pptx 파일을 열어 텍스트·이미지·레이아웃을 수정할 수도 있습니다. 스킬 내부 문서가 신규 생성과 기존 파일 편집 워크플로를 구분해 안내합니다."
          },
          {
            "q": "사내 PowerPoint 템플릿을 그대로 사용할 수 있나요?",
            "a": "네. 템플릿 기반 생성과 마스터 레이아웃(슬라이드 마스터)을 지원하므로 기존 템플릿의 디자인·브랜드를 유지한 채 내용만 채워 넣을 수 있습니다. 발표자 노트와 코멘트 같은 요소도 함께 다룰 수 있습니다."
          },
          {
            "q": "별도의 API 키나 결제가 필요한가요?",
            "a": "이 스킬 자체는 외부 API 키를 요구하지 않습니다. document-skills 플러그인으로 설치되며, .pptx 생성·편집에 필요한 라이브러리와 실행 환경이 갖춰져 있어야 합니다. 정확한 의존성은 공식 문서 확인을 권장합니다."
          }
        ],
        "relatedIds": [
          "docx",
          "xlsx",
          "pdf"
        ]
      }
    },
    {
      "id": "canvas-design",
      "type": "skill",
      "name": "canvas-design",
      "description": "디자인 철학을 적용해 .png/.pdf 형태의 비주얼 아트를 만드는 Anthropic 공식 스킬. UI 목업, 포스터, 에셋 제작에 활용된다.",
      "useWhen": "포스터/그래픽/UI 목업 같은 시각 자료를 PNG/PDF로 만들어야 할 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "design",
          "visual-art",
          "mockup"
        ]
      },
      "install": {
        "method": "command",
        "command": "/plugin marketplace add anthropics/skills 후 /plugin install example-skills@anthropic-agent-skills",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/canvas-design",
      "popularity": "Anthropic 공식 example skill (example-skills 플러그인)",
      "seo": {
        "seoTitle": "canvas-design 스킬: Claude로 PNG·PDF 비주얼 아트 제작",
        "metaDescription": "canvas-design은 디자인 철학을 적용해 .png·.pdf 비주얼 아트를 만드는 Anthropic 공식 Claude 스킬. UI 목업·포스터·에셋 제작에 활용한다.",
        "summary": "canvas-design은 Anthropic이 공개한 공식 Claude 스킬(skill)로, 디자인 원칙을 반영해 .png 이미지나 .pdf 문서 형태의 비주얼 아트를 만들어 주는 도구다. Claude가 단순히 \"이미지를 생성\"하는 데 그치지 않고, 레이아웃·타이포그래피·여백·색·정렬 같은 디자인 철학을 적용해 결과물을 구성하는 것이 핵심이다. 즉, 텍스트로 의도를 전달하면 그것을 시각적 산출물로 옮겨 주는 워크플로를 제공한다.\n\n주로 푸는 문제는 \"보여줄 만한 시각 결과물이 빠르게 필요한데, 전문 디자인 툴을 직접 다루기는 부담스러운\" 상황이다. 대표 활용처는 UI 목업(화면 시안), 포스터·배너 같은 그래픽, 그리고 슬라이드·썸네일·소셜 카드 같은 각종 에셋 제작이다. 결과를 .png(래스터 이미지)나 .pdf(인쇄·공유용 문서)로 받을 수 있어, 초안 검토·공유·문서 첨부에 바로 쓰기 좋다. canvas-design 디렉터리에는 SKILL.md와 함께 canvas-fonts 같은 폰트 리소스가 포함돼, 타이포그래피 표현을 뒷받침한다.\n\n누가 쓰면 좋은가. 아이디어 단계에서 빠르게 시안을 만들고 싶은 기획자·개발자, 디자이너가 부재한 소규모 팀, 블로그·발표·마케팅용 비주얼이 필요한 1인 운영자에게 적합하다. 다만 최종 브랜드 산출물이나 픽셀 단위 정밀 제작에는 전문 디자인 도구와 디자이너 검수를 병행하는 것이 안전하다. 정확한 사용법·옵션·제약은 공식 저장소의 SKILL.md를 확인하는 것을 권장한다. 설치 명령은 본 페이지의 설치 항목을 그대로 따르면 된다.",
        "whenToUse": "전문 디자인 툴 없이 화면 시안(UI 목업)·포스터·배너·썸네일·소셜 카드 같은 시각 결과물을 빠르게 만들고 싶을 때. 텍스트로 의도를 전달해 .png 또는 .pdf 형태의 초안을 받아 공유·검토하거나 문서·발표에 첨부할 때 유용하다. 디자이너가 없는 소규모 팀이나 1인 운영의 아이디어·초안 단계에 특히 잘 맞는다. 다만 최종 브랜드 산출물은 디자이너 검수 병행을 권장한다.",
        "installNotes": "Claude Code의 plugin marketplace를 통해 anthropics/skills를 추가한 뒤 example-skills 묶음을 설치하는 방식이다(구체 명령은 설치 항목 참조). 설치 후 canvas-design 스킬이 활성화되며, 함께 제공되는 canvas-fonts 등 폰트 리소스가 타이포그래피 표현에 쓰인다. 마켓플레이스/플러그인 명칭·버전은 환경에 따라 달라질 수 있으니, 정확한 사용법과 옵션은 공식 저장소의 SKILL.md를 확인하는 것을 권장한다.",
        "securityNotes": "별도의 API 키나 비밀키가 필요하지 않은 로컬 스킬로, 결제·외부 전송이 전제되지 않는다. 다만 생성 산출물(.png/.pdf)은 로컬 파일로 저장되므로, 민감 정보(내부 화면·실데이터·개인정보)가 시안에 포함돼 외부로 공유되지 않도록 주의한다. 또한 외부에서 받은 텍스트·문서를 그대로 입력으로 넣으면 프롬프트 인젝션 위험이 있으니 신뢰할 수 없는 콘텐츠는 검토 후 사용한다. 설치는 출처가 Anthropic 공식 저장소인지 확인하고, 미확인 마켓플레이스 플러그인 설치는 피한다.",
        "faq": [
          {
            "q": "어떤 파일 형식으로 결과를 받나요?",
            "a": ".png(래스터 이미지)와 .pdf(인쇄·공유용 문서) 형태로 비주얼 아트를 생성합니다. 초안 검토, 공유, 문서·발표 첨부에 바로 쓰기 좋습니다."
          },
          {
            "q": "어떤 작업에 쓰면 좋나요?",
            "a": "UI 목업(화면 시안), 포스터·배너 같은 그래픽, 썸네일·소셜 카드 등 각종 에셋 제작에 적합합니다. 디자인 철학을 적용해 레이아웃과 타이포그래피를 구성해 줍니다."
          },
          {
            "q": "전문 디자이너를 대체하나요?",
            "a": "아이디어·초안 단계에 빠르게 시안을 만드는 데 강점이 있습니다. 최종 브랜드 산출물이나 픽셀 단위 정밀 제작은 전문 도구와 디자이너 검수를 병행하는 것을 권장합니다."
          }
        ],
        "relatedIds": [
          "frontend-design",
          "brand-guidelines",
          "pptx"
        ]
      }
    },
    {
      "id": "mcp-builder",
      "type": "skill",
      "name": "mcp-builder",
      "description": "고품질 MCP(Model Context Protocol) 서버를 만드는 가이드를 제공하는 Anthropic 공식 스킬. 잘 설계된 도구로 LLM이 외부 서비스와 상호작용하게 한다.",
      "useWhen": "새 MCP 서버를 처음부터 설계/구현하거나 도구 정의 모범사례가 필요할 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "mcp",
          "development",
          "tooling"
        ]
      },
      "install": {
        "method": "command",
        "command": "/plugin marketplace add anthropics/skills 후 /plugin install example-skills@anthropic-agent-skills",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/mcp-builder",
      "popularity": "Anthropic 공식 example skill, MCP 개발자에게 널리 참조됨",
      "seo": {
        "seoTitle": "mcp-builder: MCP 서버 제작 가이드 Anthropic 공식 스킬",
        "metaDescription": "mcp-builder는 고품질 MCP(Model Context Protocol) 서버 제작을 돕는 Anthropic 공식 Claude 스킬입니다. 도구 설계 모범 사례로 LLM과 외부 서비스를 연결합니다.",
        "summary": "mcp-builder는 고품질 MCP(Model Context Protocol) 서버를 설계·구현하도록 안내하는 Anthropic 공식 Claude 스킬입니다. MCP는 LLM이 외부 서비스·데이터·도구와 표준화된 방식으로 상호작용하게 하는 개방형 프로토콜로, 클라이언트(Claude 등)와 서버 사이에서 도구(tool)·리소스(resource)·프롬프트를 노출합니다. 이 스킬은 \"어떤 도구를 만들 것인가\"보다 \"도구를 LLM이 잘 쓰도록 어떻게 설계할 것인가\"에 초점을 둡니다. 즉 명확한 도구 이름과 설명, 적절한 입력 스키마, 모델이 오해 없이 호출할 수 있는 파라미터 정의, 사람이 읽기 좋은 응답 형식, 에러 처리 같은 모범 사례를 따르도록 작업을 안내합니다.\n\n해결하는 문제는 분명합니다. MCP 서버를 직접 만들다 보면 프로토콜 보일러플레이트, 도구 스키마 정의, 모호한 설명 때문에 모델이 도구를 잘못 호출하거나 호출하지 못하는 경우가 흔합니다. mcp-builder는 이런 함정을 줄이고, 잘 구조화된 서버 스캐폴드와 도구 설계 지침을 제공해 처음부터 일관된 품질로 작업하도록 돕습니다.\n\n핵심 활용은 새 MCP 서버를 만들거나 기존 서버의 도구 정의·문서·구조를 다듬을 때입니다. 사내 API, SaaS, 데이터베이스, 검색 등 외부 기능을 Claude가 호출 가능한 도구로 노출하려는 개발자에게 적합합니다. 이미 공개된 시간(time)·깃(git)·데이터베이스·검색 계열 MCP 서버들의 설계를 참고 모델로 삼을 수 있습니다. 다만 구체적 API 사양·SDK 버전·전송 방식(stdio, HTTP 등)은 변동될 수 있으므로 실제 구현 시에는 출처의 공식 MCP 문서와 SDK를 함께 확인하는 것을 권장합니다.",
        "whenToUse": "새로운 MCP 서버를 처음부터 만들 때, 또는 기존 서버의 도구(tool) 정의·입력 스키마·설명·응답 형식을 LLM 친화적으로 다듬어 호출 정확도를 높이고 싶을 때 적합합니다. 사내 API·SaaS·DB·검색 기능을 Claude가 부를 수 있는 도구로 노출하려는 개발자에게 유용합니다. 단순 단발 스크립트나 프로토콜 학습 없이 끝나는 일에는 과합니다.",
        "installNotes": "Claude Code에서 플러그인 마켓플레이스(anthropics/skills)를 추가한 뒤 example-skills 플러그인을 설치하면 mcp-builder 스킬이 활성화됩니다(구체 명령은 별도 표시). 별도 환경변수는 요구하지 않습니다. 스킬은 서버 제작 가이드일 뿐, MCP 자체의 런타임·SDK(Python/TypeScript 등)·전송 방식 선택은 사용자 환경에 따라 달라지므로 실제 구현·배포 전제는 출처의 공식 MCP 문서와 해당 SDK 버전을 함께 확인하는 것을 권장합니다.",
        "securityNotes": "이 스킬 자체는 가이드라 별도 비밀키를 요구하지 않습니다(env 없음). 그러나 만드는 MCP 서버는 외부 서비스에 연결되므로 위험이 거기로 옮겨갑니다. 서버가 다루는 API 키·토큰·DB 자격증명은 코드·로그·스킬 출력에 노출하지 말고 환경변수/시크릿 저장소로 분리하세요. 쓰기·삭제·결제·배포 같은 파괴적 도구를 노출할 때는 최소 권한·범위 제한·확인 절차를 두는 것이 안전합니다. 또한 도구가 반환하는 외부 콘텐츠나 설명 문자열에 프롬프트 인젝션이 섞여 모델 행동을 조작할 수 있으니, 외부 입력을 신뢰하지 말고 검증·격리하는 설계를 권장합니다.",
        "faq": [
          {
            "q": "mcp-builder는 MCP 서버를 자동으로 완성해 주나요?",
            "a": "완전 자동 생성기라기보다, 고품질 MCP 서버를 설계·구현하도록 안내하는 가이드 스킬입니다. 도구 이름·설명·입력 스키마·응답 형식 등 모범 사례를 따르도록 작업을 이끌어 처음부터 일관된 품질로 만들도록 돕습니다. 구체 구현은 사용자의 코드와 SDK 위에서 이뤄집니다."
          },
          {
            "q": "왜 도구 설계 품질이 중요한가요?",
            "a": "MCP에서 LLM은 도구의 이름과 설명, 입력 스키마만 보고 언제·어떻게 호출할지 판단합니다. 설명이 모호하거나 스키마가 부정확하면 모델이 도구를 잘못 부르거나 아예 못 부릅니다. mcp-builder는 이런 호출 정확도를 높이는 설계에 초점을 둡니다."
          },
          {
            "q": "어떤 언어나 SDK로 MCP 서버를 만들어야 하나요?",
            "a": "MCP는 여러 공식 SDK(예: Python, TypeScript)와 전송 방식을 지원하지만, 권장 스택과 버전·옵션은 변동될 수 있습니다. 실제 구현 전 출처의 공식 MCP 문서와 해당 SDK 문서를 확인하는 것을 권장합니다."
          }
        ],
        "relatedIds": [
          "skill-creator",
          "mcp-everything",
          "mcp-git"
        ]
      }
    },
    {
      "id": "skill-creator",
      "type": "skill",
      "name": "skill-creator",
      "description": "효과적인 Agent Skill을 만드는 방법을 안내하는 Anthropic 공식 메타 스킬. SKILL.md 구조와 모범사례를 가이드한다.",
      "useWhen": "직접 커스텀 스킬을 만들거나 기존 스킬을 개선/구조화하고 싶을 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "skill-authoring",
          "meta",
          "development"
        ]
      },
      "install": {
        "method": "command",
        "command": "/plugin marketplace add anthropics/skills 후 /plugin install example-skills@anthropic-agent-skills",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/skill-creator",
      "popularity": "Anthropic 공식 example skill, 스킬 제작 표준 가이드로 널리 쓰임",
      "seo": {
        "seoTitle": "skill-creator: Claude Code 스킬 제작 공식 메타 스킬 가이드",
        "metaDescription": "Anthropic 공식 메타 스킬 skill-creator로 SKILL.md 구조와 모범사례에 맞춰 Claude Agent Skill을 설계·작성·테스트·개선하는 방법을 정리했습니다.",
        "summary": "skill-creator는 Anthropic이 공식 skills 저장소에서 제공하는 \"메타 스킬\"입니다. 즉, 다른 Agent Skill을 만들고 개선하는 일을 돕는 스킬으로, Claude가 SKILL.md를 처음부터 작성하거나 기존 스킬을 다듬을 때 표준 구조와 모범사례를 안내합니다.\n\n핵심은 Agent Skill의 3계층(progressive disclosure) 구조를 따르도록 잡아주는 것입니다. (1) 항상 로드되는 메타데이터 계층 — name과 description으로, 특히 description은 스킬이 언제 발동돼야 하는지(놓치기 쉬운 엣지 케이스 포함)를 명확히 적어 트리거 정확도를 높이는 가장 중요한 요소입니다. (2) 발동 시 로드되는 본문 계층 — 대략 500줄 이하의 지침. (3) 필요할 때만 로드되는 번들 리소스 — scripts/, references/, assets/.\n\n작업 흐름도 안내합니다. 의도 정의(무엇을·언제 발동·기대 출력·테스트 필요 여부) → 인터뷰·리서치(입출력 형식과 엣지 케이스 탐색) → SKILL.md 초안 작성 → 테스트·평가(스킬 적용/미적용 비교, 어서션 채점, 벤치마크 리포트, eval 뷰어로 결과 확인) → 피드백 기반 반복 개선의 단계로 구성됩니다.\n\n권장하는 작성 원칙도 함께 제시합니다. 경직된 규칙 나열보다 \"왜 그렇게 하는지\"를 설명해 모델의 추론을 활용할 것, 불필요한 문장을 덜어 프롬프트를 간결하게 유지할 것, 테스트 과정에서 반복되는 보조 로직은 scripts/로 묶을 것, 특정 예시에 과적합하지 말고 피드백을 일반화할 것 등입니다.\n\n스킬을 자주 만들거나 사내 스킬 라이브러리를 표준화하려는 개발자, 팀의 스킬 품질·트리거 정확도를 끌어올리고 싶은 사람에게 적합합니다. 세부 사양은 변경될 수 있으므로 공식 문서 확인을 권장합니다.",
        "whenToUse": "새 Agent Skill을 처음부터 만들 때, 기존 스킬의 description이 잘 발동되지 않거나 본문이 비대해 정리가 필요할 때, 팀 단위로 스킬 작성 규칙·디렉터리 구조(scripts/references/assets)를 표준화하고 싶을 때 유용합니다. 스킬을 테스트하고 적용/미적용 결과를 비교·평가해 반복 개선하려는 워크플로에도 맞습니다. 단순 프롬프트 한두 개 작성에는 과합니다.",
        "installNotes": "Anthropic 공식 skills 마켓플레이스를 등록한 뒤 example-skills 플러그인으로 설치하는 방식입니다(명령은 별도 표시). 플러그인 마켓플레이스 기능을 지원하는 Claude Code 버전이 전제이며, 설치 후 스킬이 목록에 노출되는지 확인하세요. 별도 API 키나 환경변수는 필요 없습니다. 마켓플레이스명·플러그인 구성은 변경될 수 있으니 공식 저장소(anthropics/skills) 문서로 최신 절차를 확인하는 것을 권장합니다.",
        "securityNotes": "별도 비밀키나 외부 토큰을 요구하지 않으며 결제·삭제 같은 파괴적 동작도 직접 수행하지 않습니다. 다만 스킬을 작성·테스트하는 과정에서 Claude가 로컬 파일을 생성·수정하고 번들 scripts/의 코드를 실행할 수 있으므로, 생성·실행되는 스크립트 내용을 검토하세요. 외부 저장소나 예시에서 가져온 SKILL.md·스크립트에는 프롬프트 인젝션이나 의도치 않은 명령이 섞일 수 있으니 신뢰할 수 없는 출처의 스킬 본문을 그대로 적용하지 말고 검수 후 사용하세요. 작성한 스킬에 API 키 등 비밀값을 하드코딩하지 마세요.",
        "faq": [
          {
            "q": "skill-creator는 일반 스킬과 무엇이 다른가요?",
            "a": "다른 스킬을 만드는 것을 돕는 메타 스킬입니다. SKILL.md의 3계층 구조와 작성·테스트·개선 워크플로, 모범사례를 안내해 스킬 자체의 품질과 트리거 정확도를 높여줍니다."
          },
          {
            "q": "SKILL.md는 어떻게 구성하나요?",
            "a": "항상 로드되는 메타데이터(name·description), 발동 시 로드되는 본문(약 500줄 이하 지침), 필요 시 로드되는 번들 리소스(scripts/·references/·assets/)의 3계층(progressive disclosure)으로 구성합니다. description이 발동 트리거의 핵심입니다."
          },
          {
            "q": "설치에 API 키가 필요한가요?",
            "a": "아니요. 별도 비밀키나 환경변수는 필요 없습니다. 플러그인 마켓플레이스를 지원하는 Claude Code 환경이면 됩니다. 절차는 변경될 수 있어 공식 문서 확인을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-builder",
          "web-artifacts-builder",
          "webapp-testing"
        ]
      }
    },
    {
      "id": "web-artifacts-builder",
      "type": "skill",
      "name": "web-artifacts-builder",
      "description": "React, Tailwind CSS, shadcn/ui로 복잡한 claude.ai HTML 아티팩트를 만드는 Anthropic 공식 스킬.",
      "useWhen": "인터랙티브한 단일 페이지 웹 아티팩트/프로토타입을 React+Tailwind+shadcn으로 빠르게 만들 때.",
      "tags": {
        "framework": [
          "react",
          "tailwind",
          "shadcn"
        ],
        "lang": [
          "javascript",
          "typescript"
        ],
        "task": [
          "frontend",
          "artifacts",
          "prototyping"
        ]
      },
      "install": {
        "method": "command",
        "command": "/plugin marketplace add anthropics/skills 후 /plugin install example-skills@anthropic-agent-skills",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/web-artifacts-builder",
      "popularity": "Anthropic 공식 example skill",
      "seo": {
        "seoTitle": "web-artifacts-builder: React·Tailwind·shadcn 클로드 아티팩트 빌더 스킬",
        "metaDescription": "Anthropic 공식 web-artifacts-builder 스킬 소개. React, Tailwind CSS, shadcn/ui로 claude.ai HTML 아티팩트를 만드는 방법, 설치, 활용 시점, 보안 주의점을 한국어로 정리했습니다.",
        "summary": "web-artifacts-builder는 Anthropic이 공식 스킬 저장소(anthropics/skills)로 제공하는 Claude용 스킬로, claude.ai에서 동작하는 복잡한 HTML 아티팩트를 React, Tailwind CSS, shadcn/ui 조합으로 구성하도록 돕습니다. 단순한 한 파일짜리 데모를 넘어, 컴포넌트 구조·상태 관리·UI 패턴이 얽힌 인터랙티브 웹 결과물을 클로드 아티팩트 환경에 맞춰 안정적으로 생성하는 데 초점이 있습니다.\n\n핵심은 \"아티팩트 환경의 제약과 관례를 스킬이 알고 있다\"는 점입니다. 클로드가 코드를 만들 때 어떤 라이브러리를 어떻게 import하고, Tailwind 유틸리티 클래스와 shadcn/ui 컴포넌트를 어떤 방식으로 조합해야 아티팩트 런타임에서 깨지지 않고 렌더링되는지에 대한 가이드를 제공합니다. 그 결과 버튼·폼·다이얼로그·카드·탭 같은 표준 UI 요소를 일관된 디자인으로 빠르게 조립하고, 프로토타입이나 도구형 미니 앱을 대화 안에서 즉시 미리 볼 수 있습니다.\n\n주요 활용 흐름은 다음과 같습니다. (1) 만들고 싶은 화면이나 기능을 클로드에게 설명하면, (2) 스킬이 React 기반 컴포넌트 구조와 Tailwind/shadcn 스타일을 적용한 아티팩트 코드를 생성하고, (3) claude.ai 아티팩트 패널에서 바로 실행·확인하며 반복 수정합니다. JavaScript와 TypeScript 작성에 모두 활용할 수 있습니다.\n\n누가 쓰면 좋은가: 아이디어를 빠르게 화면으로 검증하고 싶은 기획자·디자이너, 대시보드·폼·인터랙티브 위젯 같은 프런트엔드 시제품을 손쉽게 뽑아야 하는 개발자, 코드 작성 부담 없이 동작하는 UI 데모가 필요한 사람에게 적합합니다. 다만 아티팩트는 본격 배포용 프로덕션 코드라기보다 프로토타이핑·데모 성격이 강하므로, 실제 서비스에 옮길 때는 별도의 빌드·보안·접근성 검토가 필요합니다. 정확한 지원 범위와 최신 사용법은 공식 저장소 문서를 확인하는 것을 권장합니다.",
        "whenToUse": "React·Tailwind·shadcn/ui 기반의 인터랙티브 UI를 claude.ai 아티팩트로 빠르게 만들고 바로 미리보고 싶을 때 적합합니다. 대시보드·폼·다이얼로그·탭 같은 컴포넌트가 얽힌 미니 앱, 디자인 시안의 동작 검증, 기능 프로토타입 제작에 유용합니다. 반대로 단순 정적 HTML 한 조각이나 프로덕션 배포용 코드베이스 구축이 목적이라면 이 스킬보다 일반 프런트엔드 작업 흐름이 더 맞습니다.",
        "installNotes": "Anthropic 공식 스킬 마켓플레이스(anthropics/skills)를 추가한 뒤 example-skills 플러그인을 설치하는 방식이며, 별도의 API 키나 환경변수는 필요하지 않습니다. 이 스킬이 만든 결과물은 claude.ai 아티팩트 런타임에서 실행되도록 설계되었으므로, React·Tailwind·shadcn/ui import 관례가 아티팩트 환경에 맞춰져 있다는 점을 전제합니다. 동일 코드를 일반 프로젝트로 옮길 때는 번들러·의존성 설정이 달라질 수 있으니 최신 지원 범위와 설치 절차는 공식 저장소 문서를 확인하는 것을 권장합니다.",
        "securityNotes": "이 스킬 자체는 비밀키·결제·외부 데이터 접근을 요구하지 않으며, 코드 생성 보조에 한정됩니다. 다만 생성된 아티팩트가 외부 API를 호출하거나 사용자 입력을 받도록 작성되면, 그 안에 키·토큰을 하드코딩하지 않도록 주의해야 합니다(클라이언트 코드는 노출됨). 또한 프롬프트나 외부에서 가져온 콘텐츠를 그대로 렌더링하면 XSS 등 injection 위험이 생길 수 있으므로 입력 검증·이스케이프를 거쳐야 합니다. 아티팩트는 데모·프로토타입 성격이므로 실서비스 전 보안·접근성 검토가 필요합니다.",
        "faq": [
          {
            "q": "web-artifacts-builder로 만든 결과물을 바로 배포할 수 있나요?",
            "a": "claude.ai 아티팩트 환경에서 실행·미리보기 하는 것이 기본 용도라 프로토타입·데모에 적합합니다. 실제 서비스에 배포하려면 코드를 별도 프로젝트로 옮긴 뒤 번들러·의존성 설정, 보안·접근성 검토를 추가로 거치는 것이 좋습니다."
          },
          {
            "q": "TypeScript도 지원하나요?",
            "a": "JavaScript와 TypeScript 모두 활용할 수 있도록 태그되어 있습니다. 다만 세부 지원 범위와 권장 패턴은 버전에 따라 달라질 수 있으니 공식 저장소 문서를 확인하는 것을 권장합니다."
          },
          {
            "q": "shadcn/ui와 Tailwind를 직접 설치해야 하나요?",
            "a": "이 스킬은 claude.ai 아티팩트 런타임의 관례에 맞춰 import·스타일을 구성하도록 돕습니다. 별도 로컬 설치 없이 아티팩트에서 동작하지만, 동일 코드를 자기 프로젝트로 옮길 때는 해당 라이브러리를 직접 설정해야 합니다."
          }
        ],
        "relatedIds": [
          "frontend-design",
          "canvas-design",
          "webapp-testing"
        ]
      }
    },
    {
      "id": "webapp-testing",
      "type": "skill",
      "name": "webapp-testing",
      "description": "웹 애플리케이션을 자동으로 테스트하는 Anthropic 공식 스킬. 브라우저 상호작용으로 동작을 검증한다.",
      "useWhen": "웹앱의 UI/플로우를 실제 브라우저 조작으로 검증하거나 회귀 테스트가 필요할 때.",
      "tags": {
        "framework": [],
        "lang": [],
        "task": [
          "testing",
          "web",
          "automation",
          "e2e"
        ]
      },
      "install": {
        "method": "command",
        "command": "/plugin marketplace add anthropics/skills 후 /plugin install example-skills@anthropic-agent-skills",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/webapp-testing",
      "popularity": "Anthropic 공식 example skill",
      "seo": {
        "seoTitle": "webapp-testing 스킬 — Claude Code 웹앱 자동 브라우저 테스트(Playwright)",
        "metaDescription": "Claude Code용 Anthropic 공식 webapp-testing 스킬. Playwright(Chromium 헤드리스)로 로컬 웹앱을 실제 브라우저에서 열어 UI 동작·DOM·스크린샷·콘솔 로그를 검증한다. 설치·사용·보안 주의점 정리.",
        "summary": "webapp-testing은 Anthropic이 공식 제공하는 Claude Code 스킬로, 로컬에서 실행 중인 웹 애플리케이션을 실제 브라우저로 열어 동작을 자동 검증한다. 내부적으로 Playwright를 사용하며 Chromium을 헤드리스 모드로 띄워 페이지를 탐색한다. 핵심은 \"정찰 후 행동(reconnaissance-then-action)\" 패턴이다. 먼저 대상 URL로 이동해 네트워크가 잠잠해질 때까지(page.wait_for_load_state('networkidle')) 기다린 뒤, 스크린샷을 찍거나 렌더된 DOM을 들여다보고, 실제 페이지 상태에서 셀렉터를 발견한 다음 그 셀렉터로 클릭·입력 등 상호작용을 실행한다. 동적 SPA에서 JS가 다 실행되기 전에 요소를 만지지 않도록 로드 상태 대기를 강조한다.\\n\\n주요 기능은 다음과 같다. (1) 서버 라이프사이클 관리 — with_server.py 스크립트가 프런트엔드/백엔드 서버를 자동으로 띄우고 자동화 스크립트를 돌린 뒤 정리하며, 여러 서버 동시 구동도 지원한다. (2) DOM 검사 및 요소 탐색 — 살아있는 페이지에서 실제 셀렉터를 찾아 안정적으로 상호작용한다. (3) 브라우저 콘솔 로그 캡처 — 테스트 중 발생한 JS 에러·경고를 수집해 UI 디버깅에 활용한다. (4) 전체 페이지 스크린샷 — 시각적 회귀 확인이나 렌더 결과 점검에 쓴다.\\n\\n이런 검증을 사람이 매번 브라우저를 열어 클릭하며 확인하던 수고를, Claude Code가 코드 변경 직후 자동으로 대신하게 만든다. 프런트엔드 변경이 실제로 화면에 반영되는지, 폼·버튼·라우팅이 동작하는지, 콘솔 에러가 없는지를 빠르게 닫는 피드백 루프로 돌릴 수 있다. 프런트엔드·풀스택 개발자, E2E/스모크 테스트를 가볍게 자동화하고 싶은 팀, \"이 변경이 진짜 동작하나\"를 화면에서 확인해야 하는 상황에 적합하다. 의존성은 Playwright와 Python이며, 서버 종류에 따라 Node.js(프런트 프레임워크)나 Python(백엔드)이 추가로 필요할 수 있다. 정확한 스크립트 사용법과 최신 사양은 공식 SKILL.md 확인을 권장한다.",
        "whenToUse": "프런트엔드/풀스택 변경 후 \"실제로 화면에서 동작하는지\"를 자동 확인하고 싶을 때 적합하다. 폼 제출·버튼·라우팅 같은 UI 흐름 검증, 동적 SPA의 렌더 결과·DOM 점검, 콘솔 에러 수집, 스크린샷 기반 시각 확인, 가벼운 E2E·스모크 테스트 자동화에 쓴다. 단위 테스트만으로 잡히지 않는 통합 동작이나 \"이 PR이 진짜 되나\" 확인이 필요한 상황에 특히 유용하다.",
        "installNotes": "Anthropic 공식 example-skills 플러그인에 포함된 스킬로, 마켓플레이스 등록 후 플러그인 설치 방식으로 추가한다(명령은 별도 표시). 런타임 전제로 Python과 Playwright가 필요하며, Chromium 등 브라우저 바이너리는 Playwright의 브라우저 설치 단계가 선행돼야 한다. 테스트 대상이 프런트 프레임워크면 Node.js, 백엔드면 해당 런타임이 추가로 요구될 수 있다. 헤드리스 Chromium 실행이 가능한 환경(샌드박스·CI 포함)인지 확인하고, with_server.py로 서버를 기동하므로 대상 앱을 로컬에서 띄울 수 있어야 한다. 세부 사양은 공식 문서 확인 권장.",
        "securityNotes": "별도 API 키·비밀키는 요구하지 않는다(env 없음). 다만 실제 브라우저로 로컬 앱을 구동·조작하므로 주의가 필요하다. with_server.py가 개발 서버를 띄우고 종료시키며 페이지에서 클릭·입력을 자동 실행하므로, 로그인된 세션이나 운영 DB에 연결된 환경을 대상으로 삼으면 의도치 않은 데이터 변경·삭제가 발생할 수 있다 — 격리된 테스트/로컬 환경에서만 실행하라. 테스트 중 방문하는 페이지의 내용(DOM 텍스트·콘솔 로그)이 LLM 컨텍스트로 유입되므로, 신뢰할 수 없는 외부 콘텐츠를 렌더하면 프롬프트 인젝션 위험이 있다. 캡처한 스크린샷·로그에 민감정보가 담길 수 있으니 공유 전 점검하라.",
        "faq": [
          {
            "q": "어떤 브라우저 자동화 도구를 쓰나요?",
            "a": "Playwright를 사용하며 Chromium을 헤드리스 모드로 실행합니다. 스크립트는 sync_playwright() 동기 방식으로 페이지를 탐색합니다."
          },
          {
            "q": "Selenium이나 Cypress 같은 별도 테스트 프레임워크가 필요한가요?",
            "a": "아니요. 이 스킬은 Playwright + Python 기반으로 동작합니다. 대상 앱 종류에 따라 Node.js나 백엔드 런타임이 추가로 필요할 수 있습니다."
          },
          {
            "q": "운영 서버에 바로 써도 되나요?",
            "a": "권장하지 않습니다. 실제 클릭·입력을 자동 실행하므로 데이터 변경 위험이 있어 격리된 로컬·테스트 환경에서 쓰는 것이 안전합니다."
          }
        ],
        "relatedIds": [
          "mcp-chrome-devtools",
          "mcp-puppeteer-hisma",
          "frontend-design"
        ]
      }
    },
    {
      "id": "frontend-design",
      "type": "skill",
      "name": "frontend-design",
      "description": "전형적인 AI 룩을 피하고 완성도 높은 프론트엔드 UI를 생성하도록 돕는 Anthropic 공식 스킬. 컴포넌트·페이지·앱 디자인 품질을 끌어올린다.",
      "useWhen": "웹 컴포넌트/페이지/앱을 만들 때 디자인 품질을 높이고 싶을 때.",
      "tags": {
        "framework": [
          "claude-code",
          "react",
          "tailwind"
        ],
        "lang": [
          "javascript",
          "typescript"
        ],
        "task": [
          "frontend",
          "ui-design",
          "code-generation"
        ]
      },
      "install": {
        "method": "manual",
        "command": "git clone https://github.com/anthropics/skills 후 skills/frontend-design 를 .claude/skills/ 로 복사. 또는 /plugin 공식 마켓플레이스에서 설치.",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/frontend-design",
      "popularity": "Anthropic 공식 스킬, 프론트엔드 작업에 자주 사용됨",
      "seo": {
        "seoTitle": "frontend-design 스킬: AI 티 안 나는 고품질 프론트엔드 UI 생성 (Claude Code)",
        "metaDescription": "Anthropic 공식 frontend-design 스킬 가이드. 전형적인 AI 룩을 피하고 완성도 높은 React/Tailwind UI를 Claude Code로 생성하는 방법, 설치·활용·주의점을 정리했습니다.",
        "summary": "frontend-design은 Anthropic이 공식 스킬 저장소(anthropics/skills)에서 배포하는 Claude Code용 스킬로, 웹 컴포넌트·페이지·앱의 프론트엔드 UI를 만들 때 \"전형적인 AI가 찍어낸 듯한\" 평범한 디자인을 피하고 완성도 높은 결과물을 생성하도록 모델을 안내합니다. 일반적으로 LLM에 UI 코드를 그냥 요청하면 비슷비슷한 그라데이션, 과한 글로우, 보라·파랑 톤, 어색한 간격·타이포 같은 익숙한 패턴이 반복되는데, 이 스킬은 그런 결과를 줄이고 더 의도적이고 다듬어진 인터페이스 코드를 만들도록 디자인 관점의 지침과 판단 기준을 모델에게 제공합니다.\n\n핵심 동작은 \"사용자가 웹 컴포넌트/페이지/애플리케이션을 만들어 달라\"고 요청할 때 활성화되어, 레이아웃·타이포그래피·색·간격·상태(hover/focus/disabled) 등 시각적 완성도를 끌어올리는 방향으로 코드 생성을 보강하는 것입니다. 태그상 React·Tailwind CSS, JavaScript/TypeScript 환경을 주된 대상으로 하며, frontend·UI 디자인·코드 생성 작업에 맞춰져 있습니다.\n\n이런 사람에게 적합합니다: Claude Code로 랜딩 페이지·대시보드·컴포넌트를 빠르게 만들되 디자인 품질까지 챙기고 싶은 개발자, 디자이너 없이 프로토타입을 만드는 1인·소규모 팀, \"AI가 만든 티\"를 줄이고 싶은 프론트엔드 작업자입니다. 다만 이 스킬은 디자인 방향을 안내하는 보조 도구이지 디자인 시스템·브랜드 가이드 자체를 대체하지는 않습니다. 프로젝트 고유 토큰·정합성 규칙이 있다면 함께 적용하는 편이 좋고, 정확한 설치·동작 범위는 출처(공식 저장소) 문서를 확인하길 권장합니다.",
        "whenToUse": "Claude Code로 랜딩 페이지·대시보드·폼·카드 등 웹 컴포넌트나 페이지, 작은 앱의 UI 코드를 생성할 때, 특히 결과가 \"전형적 AI 룩(과한 그라데이션·글로우·보라파랑 톤)\"으로 나오는 걸 피하고 더 다듬어진 디자인을 원할 때 적합합니다. React·Tailwind·TypeScript 환경의 프론트엔드 작업, 디자이너 없이 빠르게 완성도 있는 프로토타입을 만들어야 하는 상황에 유용합니다.",
        "installNotes": "설치는 Anthropic 공식 스킬 저장소를 클론한 뒤 skills/frontend-design 디렉터리를 프로젝트의 .claude/skills/ 아래로 복사하거나, Claude Code의 공식 플러그인 마켓플레이스(/plugin)에서 설치하는 두 방식이 있습니다(구체 명령은 별도 표시). 스킬은 Claude Code 환경을 전제로 하며, 생성 결과를 실제로 빌드·확인하려면 Node.js와 해당 프로젝트의 프런트 빌드 환경(예: React+Tailwind)이 따로 필요합니다. 별도 API 키나 환경변수는 요구하지 않으며, 버전·디렉터리 구조가 바뀔 수 있으니 출처 문서를 확인하세요.",
        "securityNotes": "이 스킬은 별도 API 키·시크릿이나 외부 네트워크 호출을 요구하지 않고, 디자인 지침을 모델에 제공해 로컬에서 UI 코드를 생성하는 보조 도구입니다. 다만 생성된 프런트 코드는 그대로 신뢰하지 말고 검토해야 합니다. 외부 이미지·폰트·CDN·서드파티 스크립트를 끌어오는 마크업이 포함될 수 있고, 사용자 입력을 다루는 컴포넌트에서 XSS(예: dangerouslySetInnerHTML, 미검증 링크) 위험이 생길 수 있습니다. 또한 프롬프트에 붙여 넣는 외부 디자인 참고 자료에 악의적 지시가 섞이는 injection 가능성에 유의하세요. 자동 삭제·결제 같은 위험 동작은 없습니다.",
        "faq": [
          {
            "q": "frontend-design 스킬을 쓰면 AI 같은 디자인이 완전히 사라지나요?",
            "a": "완전히 보장하지는 않습니다. 이 스킬은 전형적 AI 룩을 피하고 완성도를 높이는 방향으로 코드 생성을 안내하는 보조 도구이며, 최종 품질은 요청 내용·프로젝트 디자인 토큰·검토에 따라 달라집니다. 결과는 항상 검토하는 것을 권장합니다."
          },
          {
            "q": "어떤 기술 스택에서 쓸 수 있나요?",
            "a": "태그상 React·Tailwind CSS와 JavaScript/TypeScript 환경을 주 대상으로 하는 Claude Code 스킬입니다. 다른 프런트 스택에서의 동작 범위는 출처(공식 저장소) 문서를 확인하길 권장합니다."
          },
          {
            "q": "설치에 API 키가 필요한가요?",
            "a": "별도의 API 키나 환경변수는 요구하지 않습니다. 공식 스킬 저장소에서 디렉터리를 .claude/skills/로 복사하거나 /plugin 마켓플레이스로 설치하면 되며, 구체 명령은 별도 표시됩니다."
          }
        ],
        "relatedIds": [
          "brand-guidelines",
          "webapp-testing",
          "web-artifacts-builder"
        ]
      }
    },
    {
      "id": "brand-guidelines",
      "type": "skill",
      "name": "brand-guidelines",
      "description": "브랜드 가이드라인(색·타이포·톤)을 일관되게 적용해 산출물을 만드는 Anthropic 공식 스킬.",
      "useWhen": "문서/디자인/콘텐츠에 일관된 브랜드 규칙을 강제하고 싶을 때.",
      "tags": {
        "framework": [
          "claude-code"
        ],
        "lang": [],
        "task": [
          "branding",
          "design-system",
          "consistency"
        ]
      },
      "install": {
        "method": "manual",
        "command": "git clone https://github.com/anthropics/skills 후 skills/brand-guidelines 를 .claude/skills/ 로 복사. 또는 /plugin 공식 마켓플레이스에서 설치.",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/brand-guidelines",
      "popularity": "Anthropic 공식 스킬",
      "seo": {
        "seoTitle": "brand-guidelines: Claude Code 브랜드 일관성 스킬 (색·타이포·톤)",
        "metaDescription": "Anthropic 공식 Claude Code 스킬 brand-guidelines. 브랜드 색·타이포그래피·톤 규칙을 일관되게 적용해 문서·슬라이드·웹 산출물을 만든다. 설치·활용·보안 정리.",
        "summary": "brand-guidelines는 Anthropic이 공개한 Claude Code 공식 스킬로, 브랜드 가이드라인(색상·타이포그래피·톤앤매너·로고 사용 규칙 등)을 산출물 전반에 일관되게 적용하도록 돕는다. AI에게 문서·슬라이드·웹 페이지·이미지 등 결과물을 만들게 할 때 흔히 발생하는 문제는, 매번 강조색·글꼴·말투·간격이 제각각이 되어 \"브랜드 같지 않은\" 결과가 나오는 것이다. 이 스킬은 정해둔 브랜드 규칙을 컨텍스트로 끌어와 생성 단계에서부터 반영하므로, 사람이 일일이 색 코드를 붙여넣거나 톤을 교정하지 않아도 일관된 결과를 얻을 수 있다.\n\n핵심 동작은 \"브랜드 규칙의 단일 출처(SSOT)를 정의하고, 산출물 생성 시 그 규칙을 반복 적용\"하는 것이다. 브랜드 팔레트(주색·보조색·중립색), 글꼴 패밀리와 크기 스케일, 본문 톤(격식/친근함, 1인칭/2인칭), 로고·여백·금지 표현 같은 항목을 기준으로 삼아 새 결과물이 그 기준에서 벗어나지 않게 한다. pptx·docx·canvas-design 같은 산출물 생성 스킬과 함께 쓰면, \"내용은 만들되 브랜드 톤은 이 스킬이 잡아주는\" 분업이 가능하다.\n\n이런 분들에게 유용하다. (1) 사내 표준 색·글꼴·말투가 정해져 있어 AI 산출물도 그 규칙을 따라야 하는 마케팅·디자인·기획 팀, (2) 보고서·제안서·랜딩 페이지를 반복 생산하면서 매번 톤이 흔들리는 운영자, (3) 디자인 시스템/토큰을 코드와 문서에 일관되게 반영하고 싶은 프론트엔드·디자인 시스템 담당자. 설치는 공식 skills 저장소를 클론해 해당 폴더를 .claude/skills/로 복사하거나 공식 마켓플레이스에서 설치한다. 구체 사용법과 권장 디렉터리 구조는 변경될 수 있으므로 공식 저장소(github.com/anthropics/skills) 문서를 함께 확인하길 권한다.",
        "whenToUse": "AI가 만드는 문서·슬라이드·웹·이미지 산출물을 정해진 브랜드 색·글꼴·톤에 일관되게 맞춰야 할 때 적합하다. 보고서·제안서·랜딩 페이지를 반복 생산하며 결과물 톤이 매번 달라지는 팀, 디자인 시스템/브랜드 토큰을 산출물 전반에 강제하고 싶은 경우에 유용하다. 반대로 일회성 메모처럼 브랜드 일관성이 중요치 않은 작업에는 굳이 쓸 필요가 없다.",
        "installNotes": "manual 설치 방식이다. 공식 skills 저장소를 git clone 한 뒤 skills/brand-guidelines 폴더를 사용 중인 환경의 .claude/skills/ 아래로 복사하거나, 공식 마켓플레이스(/plugin)에서 설치한다. 설치 후 자신의 실제 브랜드 규칙(색 코드·글꼴·톤 정의)을 스킬이 참조할 수 있게 채워 넣어야 의미가 있다. 폴더 구조·파일명·활용 절차는 갱신될 수 있으니 공식 저장소 README/SKILL 문서를 확인하길 권한다. 별도 환경변수나 API 키는 요구하지 않는다.",
        "securityNotes": "이 스킬은 별도 비밀키·환경변수·외부 API 호출을 요구하지 않으며, 로컬 파일 기반으로 동작한다. 다만 입력하는 브랜드 자료에 미공개 색·로고·메시징 가이드 등 대외비가 포함될 수 있으니, 외부로 전송되지 않도록 취급에 유의한다. 또한 스킬 정의 파일이나 참조하는 브랜드 문서에 외부에서 받은 텍스트를 그대로 넣으면 프롬프트 인젝션 통로가 될 수 있으므로, 신뢰할 수 없는 출처의 내용을 그대로 규칙으로 삼지 않는다. 설치 시에는 공식 anthropics/skills 저장소에서만 받아 출처를 확인한다.",
        "faq": [
          {
            "q": "brand-guidelines는 무슨 일을 하나요?",
            "a": "브랜드 색·타이포그래피·톤 규칙을 컨텍스트로 끌어와 AI가 만드는 문서·슬라이드·웹 등 산출물에 일관되게 적용하는 Anthropic 공식 Claude Code 스킬입니다. 결과물의 강조색·글꼴·말투가 매번 달라지는 문제를 줄여줍니다."
          },
          {
            "q": "어떻게 설치하나요?",
            "a": "공식 skills 저장소를 git clone 한 뒤 brand-guidelines 폴더를 .claude/skills/로 복사하거나 공식 마켓플레이스(/plugin)에서 설치합니다. 설치 후 자신의 실제 브랜드 규칙을 채워 넣어야 효과가 있으며, 절차는 공식 문서 확인을 권장합니다."
          },
          {
            "q": "다른 산출물 스킬과 같이 쓸 수 있나요?",
            "a": "네. pptx·docx·canvas-design처럼 산출물을 만드는 스킬과 함께 쓰면 내용 생성은 그쪽이, 브랜드 톤·색·글꼴 일관성은 이 스킬이 담당하는 분업이 가능합니다."
          }
        ],
        "relatedIds": [
          "canvas-design",
          "pptx",
          "frontend-design"
        ]
      }
    },
    {
      "id": "doc-coauthoring",
      "type": "skill",
      "name": "doc-coauthoring",
      "description": "긴 문서를 사람과 협업해 작성·편집하는 Anthropic 공식 스킬. 문서화·기술 문서 작성 워크플로에 적합.",
      "useWhen": "기술 문서, README, 설계 문서 등을 체계적으로 공동 작성·개선할 때.",
      "tags": {
        "framework": [
          "claude-code"
        ],
        "lang": [],
        "task": [
          "documentation",
          "writing",
          "editing"
        ]
      },
      "install": {
        "method": "manual",
        "command": "git clone https://github.com/anthropics/skills 후 skills/doc-coauthoring 를 .claude/skills/ 로 복사. 또는 /plugin 공식 마켓플레이스에서 설치.",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/doc-coauthoring",
      "popularity": "Anthropic 공식 스킬",
      "seo": {
        "seoTitle": "doc-coauthoring: Claude Code 문서 협업 작성 공식 스킬",
        "metaDescription": "doc-coauthoring은 긴 문서를 사람과 협업해 단계적으로 작성·편집하는 Anthropic 공식 Claude Code 스킬입니다. 컨텍스트 수집·구조화·독자 검증 3단계로 기술 문서, 제안서, RFC를 효율적으로 완성합니다.",
        "summary": "doc-coauthoring은 Anthropic이 공식 skills 저장소(anthropics/skills)에서 제공하는 Claude Code 스킬로, 긴 분량의 문서를 사람과 AI가 협업해 체계적으로 작성·편집하도록 안내합니다. 단순히 \"글 써줘\"라고 던지면 맥락이 빠지거나 톤이 안 맞아 결국 통째로 다시 쓰게 되는 문제를, 단계를 나눈 구조화된 워크플로로 해결합니다.\n\n핵심은 3단계 진행입니다. (1) 컨텍스트 수집 — 배경 정보를 모으고 명확화 질문을 주고받아 사람과 Claude가 같은 이해를 공유합니다. (2) 구조화·다듬기 — 문서를 섹션 단위로 쪼개 질문·브레인스토밍·선택지 큐레이션을 거치며, 전체를 다시 출력하지 않고 필요한 부분만 외과적으로 수정(surgical edit)합니다. (3) 독자 검증 — 별도의 Claude 인스턴스(서브에이전트)를 실제 독자처럼 세워 문서를 읽혀 모호함·사각지대를 미리 잡아냅니다. 사용자는 문서를 직접 고치기보다 수정안에 피드백을 주고, Claude가 그 스타일 선호를 학습해 다음 섹션에 반영합니다.\n\n주요 특징은 효율과 품질의 균형을 맞춘 단계별 가이드, 아티팩트 기반의 부분 편집, Slack·Teams·Google Drive 등에서 맥락을 끌어오는 통합 지원, 서브에이전트 독자 테스트, 그리고 원하면 단계를 건너뛰거나 자유 작성할 수 있는 사용자 재량입니다.\n\n기술 문서, 제품/기능 사양, 제안서, 의사결정 문서(RFC·design doc), 블로그 장문 등 \"구조가 필요한 긴 글\"을 쓰는 사람에게 적합합니다. 빠른 초안보다 독자에게 실제로 통하는 문서를 만드는 데 무게를 둡니다. 세부 동작과 최신 사용법은 공식 SKILL.md 확인을 권장합니다.",
        "whenToUse": "기술 문서·제품 사양·제안서·RFC·의사결정 문서·장문 블로그처럼 구조가 필요한 긴 글을 작성하거나 대대적으로 개편할 때 쓰기 좋습니다. 한 번에 완성하기보다 맥락을 정리해 섹션별로 다듬고, 발행 전에 독자 관점 검증까지 거치고 싶을 때 특히 유용합니다. 반대로 한두 문장 메모나 간단한 코멘트 작성에는 과합니다.",
        "installNotes": "공식 anthropics/skills 저장소를 clone해 skills/doc-coauthoring 디렉터리를 프로젝트나 사용자 홈의 .claude/skills/ 아래로 복사하면 됩니다. 또는 Claude Code의 /plugin 공식 마켓플레이스에서 설치할 수 있습니다. 설치 후 Claude Code가 스킬 목록에서 인식하는지 확인하세요. 별도 API 키나 외부 서비스 토큰은 필요 없으며, 독자 검증 단계의 서브에이전트 기능은 사용 환경(클라이언트)이 지원할 때만 동작합니다. 정확한 경로·설치 방식은 저장소 최신 README와 SKILL.md를 확인하길 권장합니다.",
        "securityNotes": "별도의 비밀키나 결제·삭제 권한을 요구하지 않는 작성 보조 스킬입니다. 다만 워크플로 특성상 작성 대상 문서와 Slack·Teams·Google Drive 등 외부 소스에서 끌어온 컨텍스트가 모델에 전달되므로, 사내 기밀·개인정보·미공개 정보가 포함되지 않도록 입력 전에 점검하세요. 외부 문서를 가져올 때는 그 안에 숨은 지시문이 모델 동작을 바꾸는 프롬프트 인젝션 위험이 있으니, 신뢰할 수 없는 출처의 내용은 그대로 따르지 말고 검토하세요. 통합 연동을 쓸 경우 해당 플랫폼의 접근 권한 범위를 최소로 유지하길 권장합니다.",
        "faq": [
          {
            "q": "doc-coauthoring는 글을 자동으로 다 써주나요?",
            "a": "완전 자동 생성이 아니라 사람과의 협업을 전제로 합니다. 맥락 수집·섹션별 다듬기·독자 검증의 3단계로 진행하며, 사용자는 수정안에 피드백을 주고 Claude가 그 스타일을 학습해 반영합니다. 원하면 단계를 건너뛰고 자유롭게 쓸 수도 있습니다."
          },
          {
            "q": "어떤 종류의 문서에 적합한가요?",
            "a": "기술 문서, 제품·기능 사양, 제안서, RFC·design doc 같은 의사결정 문서, 장문 블로그처럼 구조가 필요한 긴 글에 적합합니다. 한두 문장 메모나 간단한 수정에는 과한 도구입니다."
          },
          {
            "q": "독자 검증 단계는 무엇인가요?",
            "a": "발행 전에 별도의 Claude 인스턴스(서브에이전트)를 실제 독자처럼 세워 문서를 읽히고, 모호하거나 빠진 부분을 찾아내는 단계입니다. 이 기능은 사용 환경이 서브에이전트를 지원할 때 동작합니다."
          }
        ],
        "relatedIds": [
          "docx",
          "pdf",
          "skill-creator"
        ]
      }
    },
    {
      "id": "claude-api",
      "type": "skill",
      "name": "claude-api",
      "description": "Claude API/Anthropic SDK 사용을 돕는 공식 스킬 — 모델 id·가격·파라미터·스트리밍·툴 사용·캐싱 레퍼런스. 메모리에 의존하지 않고 정확한 API 정보를 참조.",
      "useWhen": "Claude/Anthropic API를 코드에서 호출하거나 모델 선택·가격·토큰·캐싱을 다룰 때.",
      "tags": {
        "framework": [
          "claude-code",
          "anthropic-sdk"
        ],
        "lang": [
          "python",
          "typescript"
        ],
        "task": [
          "api-integration",
          "llm",
          "reference"
        ]
      },
      "install": {
        "method": "manual",
        "command": "git clone https://github.com/anthropics/skills 후 skills/claude-api 를 .claude/skills/ 로 복사. 또는 /plugin 공식 마켓플레이스에서 설치.",
        "env": []
      },
      "source_url": "https://github.com/anthropics/skills/tree/main/skills/claude-api",
      "popularity": "Anthropic 공식 스킬, LLM 통합 시 널리 참조됨",
      "seo": {
        "seoTitle": "claude-api 스킬: Claude API·Anthropic SDK 정확 레퍼런스",
        "metaDescription": "claude-api는 Claude API/Anthropic SDK의 모델 id·가격·파라미터·스트리밍·툴 사용·캐싱을 메모리 의존 없이 정확히 참조하게 돕는 공식 Claude Code 스킬입니다. Python/TypeScript 등 다국어 SDK 코드 작성에 유용합니다.",
        "summary": "claude-api는 Anthropic이 배포하는 공식 Claude Code 스킬로, Claude API와 Anthropic SDK를 사용해 LLM 애플리케이션을 만들 때 정확한 레퍼런스를 제공합니다. 핵심 문제는 \"기억에 의존한 추측\"입니다. 모델 id, 토큰 가격, 요청 파라미터, SDK 메서드 시그니처는 자주 바뀌고 학습 컷오프 이후에 새 모델이 나오기 때문에, 메모리만으로 코드를 쓰면 잘못된 모델 문자열(404)이나 폐기된 파라미터(400)를 만들기 쉽습니다. 이 스킬은 그런 정보를 스킬 내부 문서와 라이브 소스(WebFetch)에서 끌어와 검증된 값만 쓰도록 강제합니다.\n\n다루는 범위는 넓습니다. 현재 모델과 가격, 적응형 사고(adaptive thinking)와 effort 파라미터, 스트리밍, 함수 호출/툴 사용(SDK 툴 러너 또는 수동 에이전트 루프), 서버사이드 툴(코드 실행·웹 검색), 구조화 출력, 프롬프트 캐싱, 토큰 카운팅, 배치·파일 API, MCP 연동, 그리고 모델 마이그레이션 가이드까지 포함합니다. 언어별로 Python, TypeScript(JS 동일), Java/Kotlin/Scala, Go, Ruby, C#, PHP, 그리고 SDK가 없는 환경용 cURL 예제를 갖추고 있어 프로젝트 언어를 감지한 뒤 해당 SDK의 정확한 호출 형태를 안내합니다. 또한 서버가 에이전트 루프를 직접 돌리는 Managed Agents 같은 상위 추상화도 별도로 설명합니다.\n\n누가 쓰면 좋은가: Claude로 분류·요약·추출·챗봇·에이전트·RAG·LLM 심판 등 LLM 기능을 새로 추가하거나 디버깅하는 개발자, 모델을 최신 버전으로 옮기려는 팀, 스트리밍/툴콜/토큰/거절(refusal) 같은 까다로운 동작을 정확히 다뤄야 하는 경우입니다. 트리거 원칙은 명확합니다 — 프롬프트에 Claude/Anthropic/Opus/Sonnet/Haiku 등이 등장하거나 LLM의 가격·모델 선택·한도·캐싱을 묻는 작업이면 기억으로 답하지 말고 이 스킬을 먼저 참조합니다. 반대로 OpenAI/Gemini 등 다른 공급자를 다루는 코드에는 적용하지 않습니다.",
        "whenToUse": "Claude API/Anthropic SDK로 코드를 추가·수정·디버깅할 때, 즉 분류·요약·추출·챗봇·툴 사용·에이전트·RAG 같은 LLM 기능을 Claude로 구현하거나, 모델을 최신 버전으로 마이그레이션하거나, 스트리밍·토큰·가격·캐싱·거절 처리 같은 세부 동작을 정확히 알아야 할 때 사용합니다. 프롬프트에 Claude/Anthropic/Opus/Sonnet/Haiku가 언급되면 기억 대신 이 스킬을 먼저 참조하세요. 단, OpenAI·Gemini 등 다른 공급자를 다루는 파일에는 쓰지 않습니다.",
        "installNotes": "공식 스킬 저장소를 git clone 한 뒤 skills/claude-api 폴더를 프로젝트 또는 사용자 디렉터리의 .claude/skills/ 아래로 복사하거나, Claude Code의 공식 /plugin 마켓플레이스에서 설치합니다. 환경변수나 별도 API 키는 필요 없습니다(스킬은 참조 문서일 뿐 직접 API를 호출하지 않음). 다만 스킬이 안내하는 코드를 실제로 실행하려면 ANTHROPIC_API_KEY 같은 자격증명과 해당 언어 SDK 패키지가 따로 필요합니다. \"최신\" 정보가 필요할 때는 라이브 문서 WebFetch가 동작하도록 네트워크 접근이 권장됩니다.",
        "securityNotes": "이 스킬 자체는 추가 권한이나 비밀키를 요구하지 않습니다. 하지만 스킬이 생성한 코드를 실행하려면 ANTHROPIC_API_KEY(또는 OAuth 토큰)가 필요하며, 키는 환경변수·시크릿 매니저로 관리하고 코드·로그·프롬프트에 하드코딩하지 마세요. 키 유출은 직접 과금 피해로 이어집니다. 툴 러너는 Claude 요청 시 함수를 자동 실행하므로 메일 발송·DB 변경·삭제 등 부수효과 툴은 입력 검증과 승인 게이트(수동 루프)를 두는 게 안전합니다. 사용자 입력이나 외부 콘텐츠가 프롬프트에 들어가면 인젝션 위험이 있으니, 운영 지시는 신뢰 가능한 system 채널로 전달하세요.",
        "faq": [
          {
            "q": "claude-api 스킬을 쓰면 Claude를 자동으로 호출하나요?",
            "a": "아니요. 이 스킬은 정확한 API 정보를 참조해 올바른 코드를 작성하도록 돕는 레퍼런스입니다. 실제 API 호출은 스킬이 생성한 코드를 ANTHROPIC_API_KEY와 SDK로 직접 실행할 때 일어납니다."
          },
          {
            "q": "어떤 언어를 지원하나요?",
            "a": "Python, TypeScript/JavaScript, Java/Kotlin/Scala, Go, Ruby, C#, PHP의 공식 SDK 예제와, SDK가 없는 환경용 cURL/raw HTTP 예제를 제공합니다. 스킬이 프로젝트 언어를 감지해 해당 SDK의 정확한 호출 형태를 안내합니다."
          },
          {
            "q": "OpenAI·Gemini 등 다른 LLM에도 쓸 수 있나요?",
            "a": "아니요. 이 스킬은 Claude/Anthropic SDK 코드를 위한 것입니다. 다른 공급자를 다루는 파일에는 적용하지 않으며, 최신 모델 id나 가격이 불확실할 때는 공식 문서 확인을 권장합니다."
          }
        ],
        "relatedIds": [
          "mcp-builder",
          "skill-creator",
          "webapp-testing"
        ]
      }
    }
  ]
}