BCN바르셀로나
LHR런던 히스로
출발16:3018:00
간단한 단계로 연결해요
AI 클라이언트에서 시작하세요. byAir 로그인 화면이 열리고, 접근을 허용하면 클라이언트로 돌아가요.
01
연결 방법 선택
Claude 디렉터리에서 byAir를 추가하거나 원격 MCP와 OAuth를 지원하는 클라이언트에 MCP URL을 붙여 넣으세요.
02
byAir에 로그인
기존 byAir 계정으로 Google, Apple 또는 이메일로 받은 코드를 사용해 로그인하세요.
03
접근 허용
byAir 데이터를 보고 관리하기 위해 요청된 권한을 확인하세요.
04
도우미로 돌아가기
AI 클라이언트로 돌아가 항공편과 여행 정보를 활용하세요.
byAir MCP 서버가 할 수 있는 일
byAir MCP 도구로 항공편, 여행, 공항, 여행 기록과 친구가 공유한 항공편을 확인하고 활용하세요.
항공편 상세 및 상태
자세한 비행 데이터, 계산된 단계, 도착 항공기 컨텍스트, 게이트, 수하물, 실시간 상태를 확인하세요.
검색 및 탐색
번호나 노선으로 항공편을 검색하고, 공항을 조회하고, 후속 작업을 위해 항공사와 공항 ID를 확인하세요.
여행 관리
여행을 나열하고, 항공편을 추가하거나 제거하고, 수동 항공편을 만들고, 여행 이름을 바꾸고, 여행을 병합하거나 분할하고, 여행 목적을 업데이트해요.
공항 컨텍스트
여행 전에 공항 세부 정보, 비행 게시판, 커뮤니티 팁, 지연 신호를 확인하세요.
통계, 공유 및 내보내기
프로필 및 항공편 통계를 읽고, 예약 세부정보와 알림을 업데이트하고, 공유 가능한 항공편 세부정보를 생성하고, 항공편을 내보냅니다.
친구와 공유 항공편
초대 링크를 생성해 친구와 연결하고 친구가 공유한 항공편을 확인하세요.
AI 클라이언트 설정
아래에서 클라이언트를 선택하세요. Claude 디렉터리에서 byAir를 추가하거나 공개 MCP URL로 사용자 지정 연결을 설정할 수 있어요. 안내가 나오면 본인의 byAir 계정으로 로그인하세요.
Claude
Claude DirectoryClaude 디렉터리에서 byAir 커넥터를 추가해 Claude에서 항공편과 여행 정보를 활용하세요.
- Claude 디렉터리에서 byAir를 열고 커넥터를 추가하세요. 안내가 나오면 Claude에 로그인하세요.
- 본인의 byAir 계정으로 로그인하고 접근을 허용하세요.
- Claude로 돌아와 채팅에서 byAir를 활성화하고 항공편과 여행에 대해 물어보세요.
ChatGPT
developers.openai.com웹 버전 ChatGPT에 OAuth를 사용하는 사용자 지정 MCP 서버로 byAir를 연결하세요.
byAir 커넥터는 현재 심사 중이에요. 사용자 지정 MCP 설정의 이용 가능 여부는 요금제, 워크스페이스 권한, 보안 설정에 따라 달라요. 최신 요구 사항은 공식 가이드를 확인하세요.
- ChatGPT Plugins에서 Add custom MCP server를 선택하고 이름을 byAir로 지정하세요.
- Server URL에 https://api.byairapp.com/mcp 를 입력하고 OAuth 인증을 선택하세요.
- 플러그인을 만들고 안내에 따라 byAir에 로그인한 다음, 사용 전에 접근을 허용하세요.
Claude Code
code.claude.comHTTP 서버를 추가한 다음 Claude Code에서 /mcp를 사용해 byAir 인증을 진행하세요.
claude mcp add --transport http byair https://api.byairapp.com/mcp원격 서버를 등록한 다음 로그인 명령을 실행해 로그인하고 접근을 허용하세요.
codex mcp add byair --url https://api.byairapp.com/mcp
codex mcp login byairPerplexity
perplexity.aiOAuth 인증을 사용하는 사용자 지정 원격 커넥터로 byAir를 연결하세요.
사용자 지정 커넥터 이용 가능 여부는 요금제와 조직 설정에 따라 달라요.
- Account settings → Connectors를 열고 + Custom connector → Remote를 선택하세요.
- MCP Server URL에 https://api.byairapp.com/mcp 를 입력하세요. OAuth와 Streamable HTTP를 선택하세요.
- 커넥터를 추가한 다음 카드를 열어 byAir에 로그인하고 활성화하세요.
OpenClaw
github.commcporter로 byAir를 등록하고 OAuth 로그인을 완료한 다음, OpenClaw에서 도구를 사용하세요.
npx mcporter config add byair https://api.byairapp.com/mcp
npx mcporter auth byair기존 연결 방식 — 개인 API 키
기존 개인 링크는 계속 작동해요. 새 연결에는 OAuth를 권장해요. 클라이언트가 OAuth를 지원하지 않으면 byAir 앱의 개인 링크를 사용하세요.
앱에서 개인 링크 찾기
Profile → Automations → AI Integration (MCP)전체 개인 URL을 서버 URL로 사용하세요. 별도의 인증 방식을 묻는 클라이언트에서는 None을 선택하세요. URL에 API 키가 이미 포함되어 있어요.
https://api.byairapp.com/mcp?api_key=YOUR_API_KEY개인 링크의 ?api_key= 쿼리 매개변수에는 비밀 정보가 있어요. 링크를 가진 사람은 누구나 byAir 데이터를 읽고 변경할 수 있으므로 공유하지 마세요.
링크가 노출되면 앱에서 API 키를 취소하거나 재생성하세요. 이전 링크를 사용하는 클라이언트도 업데이트하세요. 이 작업은 OAuth 접근 권한과 별개예요.
Claude Code
claude mcp add --transport http byair "https://api.byairapp.com/mcp?api_key=YOUR_API_KEY"Codex
codex mcp add byair --url "https://api.byairapp.com/mcp?api_key=YOUR_API_KEY"OpenClaw / mcporter
mcporter config --config ~/.mcporter/mcporter.json add byair https://api.byairapp.com/mcp?api_key=YOUR_API_KEY내 계정. 내가 허용한 권한.
OAuth로 개인 API 키를 공유하지 않고 연결할 수 있어요. 접근을 허용하기 전에 요청된 권한과 선택한 AI 서비스를 확인하세요.
- 공개 MCP URL은 공유해도 돼요. 기존 방식의 개인 링크에는 비밀 정보가 있으므로 다른 사람에게 공유하지 마세요.
- 연결된 클라이언트는 허용된 권한 범위 안에서 byAir 데이터를 읽고 변경할 수 있어요.
- byAir 웹사이트에서 로그아웃해도 OAuth 연결은 취소되지 않아요. 접근 권한을 취소하려면 connect@byairapp.com으로 이메일을 보내 주세요.
- 접근 권한을 취소하면 이후 요청이 중단돼요. AI 서비스가 이미 받은 데이터는 자동으로 삭제되지 않으며, 해당 서비스의 개인정보 처리방침과 계정 설정이 적용돼요.
자주 묻는 질문
byAir를 설치하고 AI 도우미에 연결하세요
byAir 계정을 만들고 항공편을 추가해 즐겨 쓰는 AI 도우미에서 여행 정보를 활용하세요.
