Callabo MCP 설정하기: Codex·Claude Code 연결 가이드

Callabo MCP를 PAT로 인증해 Codex와 Claude Code에 안전하게 연결하는 방법을 안내합니다. 서버 URL, 워크스페이스 허용 설정, 환경 변수, 조회 도구와 인증·권한 오류 해결 방법까지 확인하세요.

jelly

Aug 21, 2026

Callabo MCP 설정하기: Codex·Claude Code 연결 가이드

Contents

Callabo MCP 연결 전 준비 사항 확인하기 워크스페이스에서 MCP 사용을 허용하기 MCP 서버 URL과 PAT를 환경 변수로 준비하기 Codex와 Claude Code에 Callabo MCP 연결하기 Codex에 연결하기 Claude Code에 연결하기 다른 MCP 클라이언트에 연결하기 Callabo MCP 조회 도구 사용하기 연결 해제와 PAT 교체하기 Callabo MCP 연결 오류 해결하기 UNAUTHORIZED 또는 인증 오류가 발생할 때 워크스페이스가 보이지 않을 때 특정 도구나 미팅만 보이지 않을 때 설정은 있는데 연결되지 않을 때

Callabo MCP는 외부 AI 도구에서 사용자가 접근할 수 있는 Callabo 미팅 데이터를 조회하는 원격 MCP 서버입니다. 개인 액세스 토큰(PAT)으로 인증한 뒤 Codex, Claude Code처럼 Streamable HTTP를 지원하는 MCP 클라이언트에 연결할 수 있습니다.

현재 Callabo MCP 도구는 조회 전용입니다. 미팅을 생성·수정·삭제하지 않으며, PAT를 발급한 사용자의 워크스페이스·팀·미팅 권한보다 넓은 데이터를 반환하지 않습니다. 다만 대화록과 인사이트에는 민감한 업무 정보가 포함될 수 있으므로, 신뢰할 수 있는 기기와 클라이언트에서만 연결하세요.

Callabo MCP 연결 전 준비 사항 확인하기

연결에는 다음 세 가지가 필요합니다.

Callabo에서 발급한 활성 PAT
대상 워크스페이스의 개인 액세스 토큰 사용 허용
대상 워크스페이스의 MCP 사용 허용

PAT는 내 설정 > 보안 > 개인 액세스 토큰에서 발급합니다. 원문은 발급 직후 한 번만 표시되므로 안전한 비밀 저장소에 보관하세요. 자세한 절차는 Callabo PAT 발급 가이드를 먼저 확인할 수 있습니다.

워크스페이스 주소가 https://callabo.ai/ko/w/rtzr라면 마지막 경로인 rtzr가 workspace slug입니다. MCP는 먼저 접근 가능한 워크스페이스를 확인하고, 이후 조회 도구에 이 slug를 전달합니다.

워크스페이스에서 MCP 사용을 허용하기

Callabo 왼쪽 메뉴에서 대상 워크스페이스를 선택합니다.
워크스페이스 설정 > 보안으로 이동합니다.
개인 액세스 토큰 사용 허용이 허용인지 확인합니다.
MCP 사용 허용도 허용인지 확인합니다.
항목이 보이지 않거나 변경할 수 없다면 워크스페이스 관리자에게 요청합니다.

두 항목은 서로 독립적입니다. PAT 사용은 허용돼 있어도 MCP 사용이 꺼져 있으면 그 워크스페이스는 MCP의 접근 가능 목록에서 제외됩니다. 반대로 MCP를 허용했더라도 PAT 사용이 꺼져 있으면 PAT로 인증한 클라이언트에서는 접근할 수 없습니다.

설정을 바꾸려면 각각의 워크스페이스 보안 설정 관리 permission이 필요하며, 계약에 따라 항목이 잠겨 있을 수 있습니다. 다른 보안 설정은 워크스페이스 설정 가이드를 참고하세요.

워크스페이스 설정 > 보안의 개인 액세스 토큰 사용 허용과 MCP 사용 허용

MCP 서버 URL과 PAT를 환경 변수로 준비하기

Callabo MCP endpoint는 다음과 같습니다.

https://api.callabo.ai/v2/mcp

클라이언트는 이 URL에 Streamable HTTP로 연결하고 아래 형태의 Authorization header를 보냅니다.

Authorization: Bearer <발급한 PAT>

PAT를 명령·JSON·문서에 원문으로 직접 적기보다 환경 변수로 준비합니다. macOS와 Linux의 현재 shell session에서는 다음처럼 설정할 수 있습니다.

export CALLABO_MCP_PAT="<발급한 PAT>"

새 터미널이나 앱을 다시 실행하면 환경 변수가 전달되지 않을 수 있습니다. 사용하는 shell이나 비밀 저장소의 방식에 맞춰 다시 주입하고, .env를 사용한다면 Git에 포함되지 않도록 확인하세요.

Codex와 Claude Code에 Callabo MCP 연결하기

Codex에 연결하기

Codex CLI에서는 환경 변수의 이름을 MCP 설정에 저장할 수 있습니다. 먼저 CALLABO_MCP_PAT가 설정된 같은 shell에서 다음 명령을 실행합니다.

codex mcp add callabo \
  --url https://api.callabo.ai/v2/mcp \
  --bearer-token-env-var CALLABO_MCP_PAT

연결 설정을 확인합니다.

codex mcp get callabo
codex mcp list

Codex를 실행한 뒤 /mcp에서 연결 상태와 제공 도구를 확인할 수도 있습니다. 로컬 사용자 설정은 기본적으로 ~/.codex/config.toml에 저장되며, 위 명령은 PAT 원문 대신 참조할 환경 변수 이름을 기록합니다. 프로젝트별 설정과 신뢰 범위 등 최신 동작은 Codex MCP 공식 문서를 확인하세요.

Claude Code에 연결하기

Claude Code의 .mcp.json은 HTTP header 안에서 환경 변수를 확장할 수 있습니다. 프로젝트에 다음 설정을 추가하고, 실제 PAT는 파일이 아니라 CALLABO_MCP_PAT 환경 변수에만 둡니다.

{
  "mcpServers": {
    "callabo": {
      "type": "http",
      "url": "https://api.callabo.ai/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${CALLABO_MCP_PAT}"
      }
    }
  }
}

환경 변수를 설정한 shell에서 Claude Code를 시작하고 연결을 확인합니다.

claude mcp get callabo
claude mcp list

Claude Code 세션 안에서는 /mcp로 상태와 도구 수를 확인할 수 있습니다. 프로젝트의 .mcp.json은 팀과 공유할 수 있는 설정 파일이므로 PAT 원문을 절대 넣지 마세요. 환경 변수가 없으면 설정을 읽지 못하므로 Claude Code를 실행한 shell에도 값이 전달됐는지 확인합니다. scope와 환경 변수 확장 방식은 Claude Code MCP 공식 문서를 참고하세요.

Callabo 웹의 개발자 가이드에는 아래 CLI 추가 명령도 제공됩니다.

claude mcp add --transport http callabo https://api.callabo.ai/v2/mcp \
  --header "Authorization: Bearer ${CALLABO_MCP_PAT}"

일반적인 shell에서는 명령 실행 전에 ${CALLABO_MCP_PAT}가 실제 값으로 치환됩니다. 설정 파일에 환경 변수 참조를 유지하려면 위 .mcp.json 방식을 사용하세요.

다른 MCP 클라이언트에 연결하기

다른 클라이언트에서도 다음 조건을 모두 지원하면 Callabo MCP를 연결할 수 있습니다.

원격 Streamable HTTP MCP server
사용자 지정 Authorization header
PAT 원문을 노출하지 않는 secret 또는 환경 변수 참조

설정 구조는 보통 다음과 비슷하지만, ${CALLABO_MCP_PAT} 환경 변수 치환 여부와 type 필드는 클라이언트마다 다릅니다.

{
  "mcpServers": {
    "callabo": {
      "url": "https://api.callabo.ai/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${CALLABO_MCP_PAT}"
      }
    }
  }
}

이 예시를 그대로 붙여넣기 전에 해당 클라이언트의 공식 문서에서 Streamable HTTP와 header 환경 변수 확장을 확인하세요. ${CALLABO_MCP_PAT}를 문자열 그대로 전송하는 클라이언트라면 인증에 실패합니다.

Callabo MCP 조회 도구 사용하기

연결 후 가장 먼저 “접근 가능한 Callabo 워크스페이스를 보여줘”라고 요청하세요. 클라이언트는 list_workspaces로 workspace slug를 확인한 뒤 필요한 조회 도구를 선택할 수 있습니다.

현재 제공 범위는 다음과 같습니다.

워크스페이스: 접근 가능한 워크스페이스, 현재 사용자, 멤버, 팀과 팀 멤버
미팅 검색: 접근 가능한 전체·팀 미팅을 텍스트, 기간, 담당자, 레이블, 녹음 출처 등으로 검색
미팅 내용: 상세 정보, 대화록, 자막, 화자별 발화, 참여자, 공유 정보와 관련 미팅
분석 결과: 미팅 인사이트와 여러 미팅의 인사이트·문맥
업무 데이터: 예정된 캘린더 미팅, 레이블과 커스텀 인사이트 템플릿
감사로그: 별도의 감사로그 조회 permission이 있는 사용자의 범위에서 조회

실제로 보이는 도구는 하나 이상의 접근 가능한 워크스페이스와 현재 사용자 permission에 따라 달라집니다. 예를 들어 미팅 조회 권한이 없으면 미팅 도구가 노출되지 않을 수 있고, 감사로그 permission이 없으면 감사로그 도구가 보이지 않습니다.

다음처럼 작고 구체적인 요청부터 시험하세요.

접근 가능한 Callabo 워크스페이스를 보여줘.

<workspace_slug>에서 지난 7일간 내가 접근 가능한 미팅을 찾아 제목과 일시만 정리해 줘.

선택한 미팅의 액션 아이템을 조회하되, 원문 대화록 전체는 출력하지 마.

AI가 조회 결과를 다른 파일이나 서비스로 옮기는 작업은 MCP의 조회 권한과 별개입니다. 외부 전송이나 저장을 요청하기 전에 대상 데이터와 실행 범위를 직접 확인하세요.

연결 해제와 PAT 교체하기

Codex에서 연결을 제거합니다.

codex mcp remove callabo

Claude Code에서 연결을 제거합니다.

claude mcp remove callabo

이 명령은 해당 클라이언트의 MCP 설정을 제거하지만 Callabo에서 발급한 PAT 자체를 폐기하지는 않습니다. 다른 클라이언트와 자동화까지 접근을 중단하려면 내 설정 > 보안 > 개인 액세스 토큰에서 PAT를 폐기하세요.

PAT가 노출됐거나 교체가 필요하면 새 PAT를 발급하고 환경 변수 값을 바꾼 뒤 클라이언트를 다시 시작합니다. 새 연결을 확인한 다음 기존 PAT를 폐기하고, shell history·설정 파일·로그에 원문이 남지 않았는지 점검하세요.

Callabo MCP 연결 오류 해결하기

`UNAUTHORIZED` 또는 인증 오류가 발생할 때

CALLABO_MCP_PAT 환경 변수가 클라이언트를 실행한 process에 전달됐는지 확인합니다.
PAT 앞뒤 공백과 줄바꿈을 제거합니다.
PAT가 만료되거나 폐기되지 않았는지 Callabo 개인 설정에서 확인합니다.
JSON에서 환경 변수 치환을 지원하지 않으면 클라이언트 전용 secret 설정을 사용합니다.
실제 PAT를 로그나 문의 내용에 붙여넣지 않습니다.

워크스페이스가 보이지 않을 때

같은 계정으로 Callabo 웹에서 대상 워크스페이스를 열 수 있는지 확인합니다.
개인 액세스 토큰 사용 허용과 MCP 사용 허용을 모두 확인합니다.
비활성화된 멤버나 워크스페이스가 아닌지 확인합니다.
먼저 접근 가능한 목록을 조회하고 URL에서 추측한 slug 대신 반환된 slug를 사용합니다.

특정 도구나 미팅만 보이지 않을 때

Callabo 웹에서 같은 사용자가 해당 미팅·팀·메뉴를 열 수 있는지 확인합니다.
사용자 역할의 미팅, 팀원, 레이블, 인사이트 또는 감사로그 permission을 확인합니다.
미팅 검색으로 record_id를 먼저 찾은 뒤 상세·대화록·인사이트를 요청합니다.
도구 목록은 permission에 따라 달라질 수 있으므로 다른 사용자 화면과 단순 비교하지 않습니다.

설정은 있는데 연결되지 않을 때

endpoint가 https://api.callabo.ai/v2/mcp인지 확인합니다.
오래된 SSE 설정 대신 Streamable HTTP 또는 http transport를 선택합니다.
codex mcp get callabo, claude mcp get callabo와 각 세션의 /mcp에서 오류를 확인합니다.
환경 변수를 바꿨다면 실행 중인 클라이언트를 완전히 종료한 뒤 다시 시작합니다.

지금 Callabo 시작하기

지원 문의에는 클라이언트 이름·버전, 발생 시각, workspace slug, MCP server URL과 오류 문구만 포함하세요. 실제 PAT와 대화록은 보내지 말고 채널톡 또는 support@callabo.ai로 문의하세요.

Contents

CALLABO

Callabo MCP 설정하기: Codex·Claude Code 연결 가이드

jelly

Aug 21, 2026

Contents

Callabo MCP 연결 전 준비 사항 확인하기

연결에는 다음 세 가지가 필요합니다.

Callabo에서 발급한 활성 PAT
대상 워크스페이스의 개인 액세스 토큰 사용 허용
대상 워크스페이스의 MCP 사용 허용

워크스페이스에서 MCP 사용을 허용하기

Callabo 왼쪽 메뉴에서 대상 워크스페이스를 선택합니다.
워크스페이스 설정 > 보안으로 이동합니다.
개인 액세스 토큰 사용 허용이 허용인지 확인합니다.
MCP 사용 허용도 허용인지 확인합니다.
항목이 보이지 않거나 변경할 수 없다면 워크스페이스 관리자에게 요청합니다.

워크스페이스 설정 > 보안의 개인 액세스 토큰 사용 허용과 MCP 사용 허용

MCP 서버 URL과 PAT를 환경 변수로 준비하기

Callabo MCP endpoint는 다음과 같습니다.

https://api.callabo.ai/v2/mcp

클라이언트는 이 URL에 Streamable HTTP로 연결하고 아래 형태의 Authorization header를 보냅니다.

Authorization: Bearer <발급한 PAT>

PAT를 명령·JSON·문서에 원문으로 직접 적기보다 환경 변수로 준비합니다. macOS와 Linux의 현재 shell session에서는 다음처럼 설정할 수 있습니다.

export CALLABO_MCP_PAT="<발급한 PAT>"

Codex와 Claude Code에 Callabo MCP 연결하기

Codex에 연결하기

Codex CLI에서는 환경 변수의 이름을 MCP 설정에 저장할 수 있습니다. 먼저 CALLABO_MCP_PAT가 설정된 같은 shell에서 다음 명령을 실행합니다.

codex mcp add callabo \
  --url https://api.callabo.ai/v2/mcp \
  --bearer-token-env-var CALLABO_MCP_PAT

연결 설정을 확인합니다.

codex mcp get callabo
codex mcp list

Claude Code에 연결하기

{
  "mcpServers": {
    "callabo": {
      "type": "http",
      "url": "https://api.callabo.ai/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${CALLABO_MCP_PAT}"
      }
    }
  }
}

환경 변수를 설정한 shell에서 Claude Code를 시작하고 연결을 확인합니다.

claude mcp get callabo
claude mcp list

Callabo 웹의 개발자 가이드에는 아래 CLI 추가 명령도 제공됩니다.

claude mcp add --transport http callabo https://api.callabo.ai/v2/mcp \
  --header "Authorization: Bearer ${CALLABO_MCP_PAT}"

다른 MCP 클라이언트에 연결하기

다른 클라이언트에서도 다음 조건을 모두 지원하면 Callabo MCP를 연결할 수 있습니다.

원격 Streamable HTTP MCP server
사용자 지정 Authorization header
PAT 원문을 노출하지 않는 secret 또는 환경 변수 참조

설정 구조는 보통 다음과 비슷하지만, ${CALLABO_MCP_PAT} 환경 변수 치환 여부와 type 필드는 클라이언트마다 다릅니다.

{
  "mcpServers": {
    "callabo": {
      "url": "https://api.callabo.ai/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${CALLABO_MCP_PAT}"
      }
    }
  }
}

Callabo MCP 조회 도구 사용하기

현재 제공 범위는 다음과 같습니다.

워크스페이스: 접근 가능한 워크스페이스, 현재 사용자, 멤버, 팀과 팀 멤버
미팅 검색: 접근 가능한 전체·팀 미팅을 텍스트, 기간, 담당자, 레이블, 녹음 출처 등으로 검색
미팅 내용: 상세 정보, 대화록, 자막, 화자별 발화, 참여자, 공유 정보와 관련 미팅
분석 결과: 미팅 인사이트와 여러 미팅의 인사이트·문맥
업무 데이터: 예정된 캘린더 미팅, 레이블과 커스텀 인사이트 템플릿
감사로그: 별도의 감사로그 조회 permission이 있는 사용자의 범위에서 조회

다음처럼 작고 구체적인 요청부터 시험하세요.

접근 가능한 Callabo 워크스페이스를 보여줘.

<workspace_slug>에서 지난 7일간 내가 접근 가능한 미팅을 찾아 제목과 일시만 정리해 줘.

선택한 미팅의 액션 아이템을 조회하되, 원문 대화록 전체는 출력하지 마.

연결 해제와 PAT 교체하기

Codex에서 연결을 제거합니다.

codex mcp remove callabo

Claude Code에서 연결을 제거합니다.

claude mcp remove callabo

Callabo MCP 연결 오류 해결하기

`UNAUTHORIZED` 또는 인증 오류가 발생할 때

CALLABO_MCP_PAT 환경 변수가 클라이언트를 실행한 process에 전달됐는지 확인합니다.
PAT 앞뒤 공백과 줄바꿈을 제거합니다.
PAT가 만료되거나 폐기되지 않았는지 Callabo 개인 설정에서 확인합니다.
JSON에서 환경 변수 치환을 지원하지 않으면 클라이언트 전용 secret 설정을 사용합니다.
실제 PAT를 로그나 문의 내용에 붙여넣지 않습니다.

워크스페이스가 보이지 않을 때

같은 계정으로 Callabo 웹에서 대상 워크스페이스를 열 수 있는지 확인합니다.
개인 액세스 토큰 사용 허용과 MCP 사용 허용을 모두 확인합니다.
비활성화된 멤버나 워크스페이스가 아닌지 확인합니다.
먼저 접근 가능한 목록을 조회하고 URL에서 추측한 slug 대신 반환된 slug를 사용합니다.

특정 도구나 미팅만 보이지 않을 때

Callabo 웹에서 같은 사용자가 해당 미팅·팀·메뉴를 열 수 있는지 확인합니다.
사용자 역할의 미팅, 팀원, 레이블, 인사이트 또는 감사로그 permission을 확인합니다.
미팅 검색으로 record_id를 먼저 찾은 뒤 상세·대화록·인사이트를 요청합니다.
도구 목록은 permission에 따라 달라질 수 있으므로 다른 사용자 화면과 단순 비교하지 않습니다.

설정은 있는데 연결되지 않을 때

endpoint가 https://api.callabo.ai/v2/mcp인지 확인합니다.
오래된 SSE 설정 대신 Streamable HTTP 또는 http transport를 선택합니다.
codex mcp get callabo, claude mcp get callabo와 각 세션의 /mcp에서 오류를 확인합니다.
환경 변수를 바꿨다면 실행 중인 클라이언트를 완전히 종료한 뒤 다시 시작합니다.

지금 Callabo 시작하기

지원 문의에는 클라이언트 이름·버전, 발생 시각, workspace slug, MCP server URL과 오류 문구만 포함하세요. 실제 PAT와 대화록은 보내지 말고 채널톡 또는 support@callabo.ai로 문의하세요.

Contents