> ## Documentation Index
> Fetch the complete documentation index at: https://dev-docs.trychainshift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 웹 커넥터

> Claude.ai·ChatGPT 웹에서 OAuth로 Chainshift MCP 연결하기

Claude.ai·ChatGPT의 **웹 커넥터**는 API 키를 헤더에 직접 넣는 방식을 지원하지 않고 **OAuth 인증**을 사용합니다. 서버 URL만 등록하면 커넥터가 OAuth 흐름(디스커버리·클라이언트 등록·토큰 교환)을 자동으로 처리하고, 사용자는 승인 화면에 조직 API 키를 붙여넣기만 하면 됩니다.

<Note>
  두 서비스 모두 커넥터 등록에 아래 서버 URL을 사용합니다.

  ```
  https://dev-platform-api.trychainshift.ai/mcp
  ```
</Note>

## Claude.ai

<Steps>
  <Step title="커넥터 추가">
    **Settings → Connectors → Add custom connector**에서 위 MCP 서버 URL을 입력합니다.
  </Step>

  <Step title="인증 시작">
    커넥터가 인증이 필요함을 감지하고 Chainshift 승인 화면을 브라우저로 엽니다. 디스커버리와 클라이언트 등록은 자동으로 진행됩니다.
  </Step>

  <Step title="API 키 붙여넣기">
    승인 화면에 조직 API 키(`cs_live_…`)를 붙여넣고 **승인**합니다.
  </Step>

  <Step title="완료">
    커넥터가 액세스 토큰을 발급받아 이후 요청에 자동으로 사용합니다. 대화창에서 Chainshift tool을 바로 호출할 수 있습니다.
  </Step>
</Steps>

## ChatGPT

<Steps>
  <Step title="커넥터 추가">
    **Settings → Connectors(또는 Apps)에서 사용자 지정 커넥터 추가**를 열고 위 MCP 서버 URL을 입력합니다.
  </Step>

  <Step title="인증 시작">
    커넥터가 OAuth 인증을 감지하고 Chainshift 승인 화면을 엽니다.
  </Step>

  <Step title="API 키 붙여넣기">
    승인 화면에 조직 API 키(`cs_live_…`)를 붙여넣고 **승인**합니다.
  </Step>

  <Step title="완료">
    연결이 완료되면 대화·Deep Research에서 Chainshift tool을 사용할 수 있습니다.
  </Step>
</Steps>

<Warning>
  발급된 토큰은 붙여넣은 **API 키에 바인딩**됩니다. 대시보드에서 해당 API 키를 폐기하면 연결된 OAuth 토큰도 즉시 무효화되어 재인증이 필요합니다.
</Warning>

<Tip>
  OAuth 디스커버리·토큰·스코프 등 기술 사양은 [OAuth 2.1](/authentication/oauth2)에서 확인하세요. Claude Code·Cursor 같은 로컬 클라이언트는 OAuth 없이 [API-Key 헤더](/mcp/connect)로 바로 연결합니다.
</Tip>