인증

모든 요청에는 API 키가 필요합니다. MCP로 연결한 AI 앱은 API 키 대신 OAuth 액세스 토큰을 사용합니다.

API 키

Authorization 헤더에 Bearer 토큰으로 키를 보냅니다.

Authorization: Bearer YOUR_API_KEY

• 키는 YouViCo 앱의 설정 → API 키에서 만들고, 재발급하고, 삭제합니다.
• 워크스페이스 소유자, 관리자, 멤버가 키를 만들 수 있습니다.
• 키는 하나의 워크스페이스에 속하며 그 워크스페이스에만 접근합니다.
• 키는 내 역할로 동작하며, 키에 부여한 API 권한 안에서만 사용할 수 있습니다.

주의

키가 외부에 노출되지 않도록 보관해야 합니다. 키가 노출되면 바로 재발급하거나 삭제해야 합니다.

OAuth 액세스 토큰

MCP로 AI 앱을 연결하면 앱은 API 키 대신 OAuth 액세스 토큰을 받습니다. 토큰은 API 키와 같이 동작합니다. 선택한 워크스페이스에 속하고, 승인한 API 권한을 가집니다. 토큰을 보내고 갱신하는 일은 앱이 처리합니다.

자격 증명 확인

Ping은 보낸 API 키나 OAuth 액세스 토큰의 워크스페이스와 API 권한을 반환합니다.