Claude에서 MCP 서버 설정하기: Jira, Firebase 완벽 가이드

MCP 서버란 무엇인가

MCP(Model Context Protocol)는 Anthropic이 개발한 표준 프로토콜로, Claude와 외부 서비스를 연결하는 브릿지 역할을 합니다.
이 프로토콜을 통해 Claude는 Jira, Firebase, GitHub, Slack 등 다양한 외부 도구와 실시간으로 통신할 수 있습니다.
기존에는 API 호출을 직접 구현해야 했지만, MCP를 사용하면 Claude가 자동으로 외부 서비스를 조회하고 조작할 수 있어 생산성이 크게 향상됩니다.

MCP는 서버-클라이언트 구조로 동작합니다.
Claude(클라이언트)가 MCP 서버에 요청을 보내면, 서버는 해당 외부 서비스와 통신하여 결과를 Claude에게 반환합니다.
이 구조 덕분에 Claude는 복잡한 인증 처리나 API 명세를 직접 알 필요 없이 자연어만으로 외부 서비스를 제어할 수 있습니다.

Claude 설정 파일 위치와 기본 구조

MCP 서버 설정은 Claude의 설정 파일인 claude_desktop_config.json에서 관리합니다.
운영체제별 설정 파일 경로는 다음과 같습니다.

운영체제	경로
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

설정 파일의 기본 구조는 아래와 같습니다.

{
  "mcpServers": {
    "서버이름": {
      "command": "실행명령",
      "args": ["인수1", "인수2"],
      "env": {
        "환경변수명": "값"
      }
    }
  }
}

설정 파일을 수정한 후에는 Claude Desktop을 완전히 종료하고 재시작해야 변경사항이 적용됩니다.
설정에 JSON 문법 오류가 있으면 Claude가 실행되지 않을 수 있으므로, JSON 검증 도구로 미리 확인하는 것을 권장합니다.

Jira MCP 서버 설정

Jira MCP 서버를 설정하면 Claude가 Jira 이슈를 조회, 생성, 수정할 수 있게 됩니다.
먼저 Atlassian 계정에서 API 토큰을 발급받아야 합니다.
Atlassian 계정 설정 페이지(id.atlassian.com/manage-profile/security/api-tokens)에 접속하여 "Create API token"을 클릭하고 토큰을 생성합니다.

다음으로 Jira MCP 서버 패키지를 설치합니다.

npm install -g @modelcontextprotocol/server-jira

설치 후 claude_desktop_config.json에 아래 설정을 추가합니다.

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-jira"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

설정이 완료되면 Claude에게 "Jira에서 오늘 할당된 이슈 목록을 보여줘"처럼 자연어로 요청할 수 있습니다.
Claude는 자동으로 Jira API를 호출하여 이슈 목록을 가져오고, 읽기 쉬운 형식으로 정리해서 보여줍니다.
이슈 생성도 가능하여 "새 버그 이슈를 만들어줘"라고 요청하면 Claude가 필요한 정보를 물어보며 이슈를 생성합니다.

Firebase MCP 서버 설정

Firebase MCP 서버를 사용하면 Claude가 Firestore 데이터베이스를 직접 조회하고 수정할 수 있습니다.
Firebase 프로젝트 콘솔에서 서비스 계정 키를 먼저 발급받아야 합니다.
Firebase 콘솔 → 프로젝트 설정 → 서비스 계정 탭에서 "새 비공개 키 생성"을 클릭하면 JSON 형식의 키 파일이 다운로드됩니다.

Firebase MCP 서버 패키지를 설치합니다.

npm install -g @modelcontextprotocol/server-firebase

설정 파일에 Firebase 서버 설정을 추가합니다.

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-firebase"],
      "env": {
        "FIREBASE_SERVICE_ACCOUNT_KEY": "/path/to/serviceAccountKey.json",
        "FIREBASE_PROJECT_ID": "your-project-id"
      }
    }
  }
}

서비스 계정 키 파일 경로는 절대 경로로 입력해야 합니다.
상대 경로를 사용하면 Claude가 다른 디렉토리에서 실행될 때 파일을 찾지 못하는 오류가 발생할 수 있습니다.
설정 완료 후 Claude에게 "users 컬렉션에서 최근 가입한 10명의 사용자를 조회해줘"처럼 요청하면 Firestore 데이터를 바로 조회할 수 있습니다.

Jira와 Firebase를 함께 사용하는 실전 예시

두 MCP 서버를 동시에 설정하면 서로 다른 서비스를 연계하는 복잡한 작업도 Claude 하나로 처리할 수 있습니다.
예를 들어 Firebase에서 오류 로그를 조회한 뒤 해당 오류에 대한 Jira 이슈를 자동으로 생성하는 워크플로가 가능합니다.
아래는 두 서버를 모두 설정한 claude_desktop_config.json 예시입니다.

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-jira"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    },
    "firebase": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-firebase"],
      "env": {
        "FIREBASE_SERVICE_ACCOUNT_KEY": "/Users/username/keys/firebase-key.json",
        "FIREBASE_PROJECT_ID": "my-project-id"
      }
    }
  }
}

이 설정으로 Claude에게 "Firebase 에러 로그에서 오늘 발생한 심각한 오류를 찾아서 각각 Jira 버그 이슈로 만들어줘"라고 요청할 수 있습니다.
Claude는 Firebase에서 오류 데이터를 가져오고, 각 오류를 분석한 뒤, Jira에 체계적인 버그 이슈를 자동으로 생성합니다.
이처럼 여러 MCP 서버를 조합하면 반복적인 수작업을 크게 줄일 수 있습니다.

트러블슈팅과 보안 주의사항

MCP 서버 설정 시 가장 흔한 오류는 환경변수 누락과 권한 문제입니다.
Claude를 재시작한 후에도 MCP 서버가 인식되지 않는다면 JSON 문법 오류나 필수 환경변수 누락을 먼저 확인하세요.
터미널에서 claude --log-level debug로 실행하면 MCP 서버 연결 오류 로그를 상세히 확인할 수 있습니다.

보안 측면에서 API 토큰과 서비스 계정 키는 절대 코드 저장소에 커밋하면 안 됩니다.
환경변수 파일(.env)을 사용하거나 운영체제의 키체인(macOS Keychain, Windows Credential Manager)에 저장하는 방식을 권장합니다.
서비스 계정에는 필요한 최소 권한만 부여하는 최소 권한 원칙을 적용하면 보안 위험을 크게 줄일 수 있습니다.

MCP 생태계는 빠르게 성장하고 있어 공식 MCP 서버 목록(github.com/modelcontextprotocol/servers)에서 지원되는 서비스를 확인할 수 있습니다.
GitHub, Slack, PostgreSQL, Notion 등 수십 가지 서비스의 MCP 서버가 이미 공개되어 있습니다.
커뮤니티에서 만든 서드파티 MCP 서버도 활발하게 개발되고 있어 앞으로 더 많은 서비스와 Claude를 연결할 수 있게 될 것입니다.