From f707388cfa37eba94a30b88987c10571fdec4a1a Mon Sep 17 00:00:00 2001 From: kakyungkim Date: Fri, 29 May 2026 20:48:13 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20Step=202A=20Claude=20Code=20Atlassian?= =?UTF-8?q?=20MCP=EB=A5=BC=20OAuth=20=EB=B0=A9=EC=8B=9D=EC=9C=BC=EB=A1=9C?= =?UTF-8?q?=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 존재하지 않는 npm 패키지(@atlassian/mcp-atlassian, 404)를 쓰던 Step 2A를 공식 remote MCP 서버(OAuth)로 교체. 그대로 따라하면 MCP가 Failed to connect 상태가 되던 문제 해결. Codex(Step 2B)와 동일한 공식 서버 사용. - claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse -s user - /mcp 에서 브라우저 OAuth 인증 - MCP용 API token 불필요 (Step 1 token은 OpenClaw/curl 호출용으로 유지) Co-Authored-By: Claude Opus 4.8 (1M context) --- guide/start-project.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/guide/start-project.md b/guide/start-project.md index 0e69ffc..1fefde9 100644 --- a/guide/start-project.md +++ b/guide/start-project.md @@ -153,24 +153,24 @@ Atlassian 공식 MCP 서버를 설정하면 Claude Code 또는 Codex가 Confluen 토큰은 생성 직후 한 번만 확인할 수 있습니다. 대화창, Slack, repo 파일에 붙여넣지 않습니다. -### Step 2A — Claude Code MCP 서버 설정 (`~/.claude/settings.json`) - -각자 본인 계정 정보로 **글로벌 설정**에 추가합니다 (프로젝트 repo에 커밋하지 말 것 — 토큰 유출 위험). - -```json -{ - "mcpServers": { - "atlassian": { - "command": "npx", - "args": ["-y", "@atlassian/mcp-atlassian", "--transport", "stdio"], - "env": { - "ATLASSIAN_URL": "https://biospin-ai.atlassian.net", - "ATLASSIAN_EMAIL": "<본인 atlassian 이메일>", - "ATLASSIAN_TOKEN": "<위에서 발급한 API token>" - } - } - } -} +### Step 2A — Claude Code MCP 서버 설정 (OAuth) + +Claude Code도 Atlassian 공식 remote MCP 서버를 OAuth로 등록합니다. 예전 `@atlassian/mcp-atlassian` npm 패키지 방식은 npm registry에 패키지가 없어(404) `✗ Failed to connect` 상태가 되므로 사용하지 않습니다. 이 방식은 **MCP용 API token이 필요 없습니다** (Step 1의 token은 OpenClaw·직접 curl 호출용으로만 사용). + +```bash +# user 스코프로 1회 등록 (모든 프로젝트에서 사용 가능) +claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse -s user + +# 이미 깨진 atlassian 서버가 있으면 먼저 제거 +# claude mcp remove atlassian -s local # 또는 -s user +``` + +등록 후 Claude Code 대화에서 `/mcp` → `atlassian` 선택 → **Authenticate** → 브라우저에서 Atlassian(biospin-ai 워크스페이스) 로그인·승인. 상태 확인: + +```bash +claude mcp get atlassian +# Status: ! Needs authentication → /mcp 인증 전 +# Status: ✓ Connected → 인증 완료, 사용 가능 ``` ### Step 2B — Codex MCP 서버 설정