> ## Documentation Index > Fetch the complete documentation index at: https://help.airbridge.io/llms.txt > Use this file to discover all available pages before exploring further. # [Beta] 에어브릿지 MCP MCP를 통해 Claude, Claude Code, ChatGPT, Codex 등 다양한 AI 서비스에서 에어브릿지 데이터를 활용할 수 있습니다. **알립니다** 이 기능은 현재 베타 버전으로 제공되고 있습니다. 서비스 안정화 과정에서 일부 사양이 변경될 수 있습니다. ## 에어브릿지 MCP MCP(Model Context Protocol)는 AI 서비스가 외부 데이터에 접근할 수 있도록 지원하는 프로토콜입니다. 에어브릿지 MCP를 사용하면 Claude, Claude Code, ChatGPT, Codex 등 AI 서비스에서 에어브릿지 데이터에 접근할 수 있습니다. 에어브릿지 MCP 설정을 완료하고 질문을 통해 리포트를 조회하거나 데이터를 탐색해 보세요. ## 에어브릿지 MCP 설정하기 에어브릿지 MCP를 사용하려면 MCP 토큰을 활성화해야 합니다. 설정 과정 중 나타나는 접근 권한 허용 페이지에서 ‘MCP Token Activation Notice(MCP 토큰 활성화 안내)’를 주의 깊게 읽어주세요. ‘I understand(이해했습니다)’ 체크박스를 선택한 후 ‘Allow(허용)’를 선택하면 MCP 토큰이 활성화됩니다. mcp 이 토큰을 활성화하면 Model Context Protocol(MCP)을 통해 **호환되는 AI 클라이언트가 Airbridge의 일부 데이터와 기능에 접근할 수 있습니다.** Airbridge MCP는 다음 원칙에 따라 운영됩니다. * **No Storage** – 데이터는 실시간 처리 후 저장되지 않습니다. * **No Training** – 고객 데이터는 AI 모델 학습에 사용되지 않습니다. * **No Sharing** – 승인된 MCP 클라이언트를 제외한 제3자와 데이터가 공유되지 않습니다. * **Encryption** – 데이터는 전송 과정에서 암호화됩니다. MCP 기능은 **Airbridge가 운영하지 않는 외부 AI 클라이언트 또는 도구와의 연동을 가능하게 할 수 있습니다.** MCP를 통해 해당 서비스로 데이터가 전송된 이후의 데이터 처리, 저장 또는 사용 방식은 해당 외부 서비스의 정책과 책임에 따릅니다. 고객은 MCP 토큰의 관리 및 보호에 대한 책임을 가지며, 어떤 클라이언트, 도구 또는 에이전트가 해당 토큰을 사용할 수 있는지 직접 통제해야 합니다. 무단 사용이 의심되는 경우 즉시 토큰을 비활성화할 것을 권장합니다. MCP 토큰을 활성화함으로써 위 조건을 이해하고 이에 동의한 것으로 간주됩니다. AI 서비스별 설정 방법을 확인하세요. MCP는 Pro, Max, Team, Enterprise 플랜에서 사용할 수 있습니다. 단, Team 또는 Enterprise 플랜에서는 먼저 Owner가 조직에 커넥터를 추가해야 합니다. 1. [claude.ai](https://claude.ai)에 접속하거나 Claude 데스크톱 앱을 실행하세요. 2. 왼쪽 하단에 있는 프로필 아이콘을 클릭하세요. 3. \[설정]>\[커넥터]로 이동해 ‘커스텀 커넥터 추가’를 클릭하세요. 4. 아래 에어브릿지 MCP 정보를 입력하세요. 1. 이름: Airbridge 2. 원격 MCP 서버 URL: [https://mcp.airbridge.io/mcp](https://mcp.airbridge.io/mcp) 5. ‘추가’를 클릭하세요. 6. \[커넥터] 페이지로 돌아와 ‘Airbridge’를 찾은 후, ‘연결’을 클릭하세요. 7. 에어브릿지 로그인 페이지가 나타납니다. 로그인해 주세요. 8. 접근 권한을 허용할 도구 목록과 ‘MCP Token Activation Notice(MCP 토큰 활성화 안내)’를 확인하세요. 9. ‘I understand(이해했습니다)’ 체크박스를 선택한 후 ‘Allow(허용)’를 클릭하세요. 10. 이제 Claude에서 에어브릿지 데이터를 바로 확인할 수 있습니다. MCP는 Pro, Max, Team, Enterprise 플랜에서 사용할 수 있습니다. 단, Team 또는 Enterprise 플랜에서는 먼저 Owner가 조직에 커넥터를 추가해야 합니다. 1. 터미널을 실행하세요. 2. 아래 명령어를 입력해 에어브릿지 MCP 서버를 추가하세요. ```bash lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}} claude mcp add -t http -s user airbridge https://mcp.airbridge.io/mcp ``` 3. 승인 요청이 나타나면 ‘Yes(예)’를 선택하세요. 4. 서버 추가가 완료되면 대화를 종료하고 터미널로 돌아가세요. 5. Claude Code를 실행하고 아래 명령어를 입력하세요. ```bash lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}} /mcp ``` 6. MCP 서버 목록에서 ‘Airbridge’를 선택하세요. 7. ‘Authenticate(인증)’을 선택하세요. 8. 에어브릿지 로그인 페이지가 나타납니다. 로그인해 주세요. 9. 접근 권한을 허용할 도구 목록과 ‘MCP Token Activation Notice(MCP 토큰 활성화 안내)’를 확인하세요. 10. ‘I understand(이해했습니다)’ 체크박스를 선택한 후 ‘Allow(허용)’를 클릭하세요. 11. 이제 Claude Code에서 에어브릿지 데이터를 바로 확인할 수 있습니다. MCP는 Plus, Pro, Business, Enterprise, Edu 플랜에서 사용할 수 있습니다. 단, Business, Enterprise, Edu 플랜에서는 먼저 Owner가 ‘개발자 모드’를 활성화하고 개별 계정에 개발자 모드 사용 권한을 부여해야 합니다. 1. [chatgpt.com](https://chatgpt.com/)에 접속하거나 ChatGPT 앱을 실행하세요. 2. 왼쪽 하단에 있는 프로필 아이콘을 클릭하세요. 3. \[설정]>\[앱]으로 이동해 ‘고급 설정’을 클릭하세요. 4. ‘개발자 모드’를 활성화하세요. 5. ‘앱 만들기’를 클릭하고 아래 에어브릿지 MCP 정보를 입력하세요. 1. 이름: Airbridge 2. MCP 서버 URL: [https://mcp.airbridge.io/mcp](https://mcp.airbridge.io/mcp) 3. 인증: OAuth 6. ‘만들기’를 클릭하세요. 7. \[앱] 페이지로 이동해 ‘Airbridge’를 클릭하세요. 8. 에어브릿지 로그인 페이지가 나타납니다. 로그인해 주세요. 9. 접근 권한을 허용할 도구 목록과 ‘MCP Token Activation Notice(MCP 토큰 활성화 안내)’를 확인하세요. 10. ‘I understand(이해했습니다)’ 체크박스를 선택한 후 ‘Allow(허용)’를 클릭하세요. 11. 이제 ChatGPT에서 에어브릿지 데이터를 바로 확인할 수 있습니다. 1. 터미널을 실행하세요. 2. 아래 명령어를 입력해 에어브릿지 MCP 서버를 추가하세요. ```bash lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}} codex mcp add airbridge --url https://mcp.airbridge.io/mcp ``` 3. 에어브릿지 로그인 페이지가 나타납니다. 로그인해 주세요. 4. 접근 권한을 허용할 도구 목록과 ‘MCP Token Activation Notice(MCP 토큰 활성화 안내)’를 확인하세요. 5. ‘I understand(이해했습니다)’ 체크박스를 선택한 후 ‘Allow(허용)’를 클릭하세요. 6. 이제 Codex에서 에어브릿지 데이터를 바로 확인할 수 있습니다. **알립니다** Codex CLI와 IDE Extention은 설정을 공유하므로 한 번만 설정하면 두 환경 모두에서 에어브릿지 MCP를 사용할 수 있습니다. ## 제공되는 에어브릿지 도구 * 에어브릿지 대시보드와 동일한 범위의 기능을 AI 서비스에서 활용할 수 있습니다. * 특정 조직, 앱, 기능에 대한 접근 권한은 에어브릿지 계정 권한을 따릅니다. ### 기본 허용 도구 | 이름 | 설명 | | ------------------------- | -------------------------------- | | Get Guide | 에어브릿지 헬프 센터에서 특정 가이드의 내용을 조회합니다. | | List Guides | 에어브릿지 헬프 센터에서 가이드 목록을 조회합니다. | | Search Dashboard Pages | 에어브릿지 대시보드에서 키워드로 검색합니다. | | Select App | 접근 가능한 앱 목록을 조회합니다. | | Setup SDK Deeplink | 플랫폼별 에어브릿지 SDK 딥링킹 설정 안내를 생성합니다. | | Setup SDK Install | 플랫폼별 에어브릿지 SDK 설치 안내를 생성합니다. | | Setup SDK Troubleshooting | 플랫폼별 에어브릿지 SDK 트러블슈팅 안내를 생성합니다. | ### 별도 허용이 필요한 도구 | 이름 | 설명 | | ---------------------------------- | ---------------------------------------------------------- | | Get Active Users Group By Metadata | 액티브 유저 리포트에서 사용할 수 있는 그룹바이를 조회합니다. 리포트 조회에 필요합니다. | | Get Active Users Metrics Metadata | 액티브 유저 리포트에서 사용할 수 있는 메트릭을 조회합니다. 리포트 조회에 필요합니다. | | Get Active Users Report | 액티브 유저 리포트를 조회합니다. | | Get Actuals Group By Metadata | 액츄얼스 리포트에서 사용할 수 있는 그룹바이를 조회합니다. 리포트 조회에 필요합니다. | | Get Actuals Metrics Metadata | 액츄얼스 리포트에서 사용할 수 있는 메트릭을 조회합니다. 리포트 조회에 필요합니다. | | Get Actuals Report | 액츄얼스 리포트를 조회합니다. | | Get App Info | 에어브릿지 앱 정보를 조회합니다. | | Get Deeplink Android | 안드로이드 HTTP 딥링크(App Link) 설정을 조회합니다. | | Get Deeplink iOS | iOS HTTP 딥링크(Universal Link) 설정을 조회합니다. | | Get Deeplink URI Schemes | 안드로이드와 iOS 딥링크 URI 스킴을 조회합니다. | | Get Organization Info | 조직의 상세 정보를 조회합니다. | | Get Organization Plans | 조직의 플랜 및 결제 정보를 조회합니다. | | Get Raw Export URL | 원본 데이터를 추출해 CSV 파일로 다운로드할 수 있는 링크를 제공합니다. | | Get Retention Events Metadata | 리텐션 리포트에서 사용할 수 있는 스타트 이벤트와 리턴 이벤트를 조회합니다. 리포트 조회에 필요합니다. | | Get Retention Group By Metadata | 리텐션 리포트에서 사용할 수 있는 그룹바이를 조회합니다. 리포트 조회에 필요합니다. | | Get Retention Measurement Options | 리텐션 리포트에서 사용할 수 있는 메저먼트 옵션을 조회합니다. 리포트 조회에 필요합니다. | | Get Retention Report | 리텐션 리포트를 조회합니다. | | Get Retention Types Metadata | 리텐션 리포트에서 사용할 수 있는 리텐션 타입을 조회합니다. 리포트 조회에 필요합니다. | | Get Revenue Events Metadata | 레비뉴 리포트에서 사용할 수 있는 스타트 이벤트와 레비뉴 이벤트를 조회합니다. 리포트 조회에 필요합니다. | | Get Revenue Group By Metadata | 레비뉴 리포트에서 사용할 수 있는 그룹바이를 조회합니다. 리포트 조회에 필요합니다. | | Get Revenue Metrics Metadata | 레비뉴 리포트에서 사용할 수 있는 메트릭과 서브 메트릭을 조회합니다. 리포트 조회에 필요합니다. | | Get Revenue Report | 레비뉴 리포트를 조회합니다. | | Get Tracking Link | 특정 트래킹 링크의 상세 정보를 조회합니다. | | List Organization Apps | 에어브릿지 앱 목록을 조회합니다. 계정이 여러 조직에 속한 경우 조직별로 조회할 수 있습니다. | | List Tracking Links | 트래킹 링크 목록을 조회합니다. | | Search App Store | 키워드로 앱스토어에서 앱을 검색합니다. | **주의하세요** 아래 도구들은 에어브릿지 대시보드 설정을 직접 수정합니다. 쓰기/삭제는 읽기 권한을 포함합니다. | 이름 | 설명 | | --------------------------- | ----------------------------------------- | | Update App Platforms | 에어브릿지 앱의 플랫폼(안드로이드, iOS, 웹사이트) 정보를 수정합니다. | | Update Deeplink Android | 안드로이드 HTTP 딥링크(App Link) 설정을 수정합니다. | | Update Deeplink iOS | iOS HTTP 딥링크(Universal Link) 설정을 수정합니다. | | Update Deeplink URI Schemes | 안드로이드와 iOS 딥링크 URI 스킴을 수정합니다. | **주의하세요** 아래 도구에 접근 권한을 허용하면 인증 정보가 AI 서비스 제공자의 서버로 전송됩니다. 전송된 인증 정보는 사용자의 AI 서비스 설정에 따라 모델 학습에 사용될 수 있으니 유의해 주세요. | 이름 | 설명 | | ------------- | ------------------------- | | Get App Token | 에어브릿지 앱의 앱 SDK 토큰을 조회합니다. | | Get Web Token | 에어브릿지 앱의 웹 SDK 토큰을 조회합니다. |