> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/get-started/ko/agents/setup.md).

# Roboflow Agent 설정

코딩 에이전트가 Roboflow에 연결하기 위해 따르는 설정 지침입니다.

코딩 에이전트를 위한 지침입니다. 사람이면 대신 [MCP 서버](/get-started/ko/agents/mcp-server.md) 를 읽으세요.

이 세션을 다음 주소의 Roboflow MCP 서버에 연결하세요: `https://mcp.roboflow.com/mcp`. 두 단계는 에이전트가 아니라 사용자가 수행해야 합니다. OAuth 로그인은 브라우저에서 진행되며, 클라이언트를 다시 시작해야 서버가 로드됩니다. 에이전트가 할 일을 마친 뒤, 사용자가 따라 할 지침을 한 번에 하나씩 안내하세요.

## 1. 서버 추가

이미 `roboflow` 가 `claude mcp list` 또는 `codex mcp list`에 표시된다면 이 단계는 건너뛰세요. 중복해서 추가하지 마세요.

```bash
claude mcp add -s user roboflow --transport http https://mcp.roboflow.com/mcp   # Claude Code
codex mcp add roboflow --url https://mcp.roboflow.com/mcp                       # Codex
```

Cursor에서는 사용자에게 다음 명령을 실행하라고 안내하세요: `/add-plugin roboflow`. 그 밖의 클라이언트에서는 MCP 설정에 `roboflow` 를 다음과 같이 추가하세요: `{"type": "http", "url": "https://mcp.roboflow.com/mcp"}`. 파일을 먼저 읽어 기존 서버 설정을 유지하세요.

## 2. 사용자에게 로그인 요청

인증은 OAuth로 처리되므로 API 키가 필요하지 않으며, 사용자에게 받아 붙여 넣을 정보도 없습니다. Claude Code에서는 다음을 실행합니다: `/mcp`, "roboflow"를 선택한 다음 "Authenticate"를 선택합니다. Codex에서는 사용자의 터미널에서 다음을 실행합니다: `codex mcp login roboflow` . 다른 클라이언트에서는 처음 사용할 때 로그인하라는 메시지가 표시됩니다. 무료 계정은 다음에서 만들 수 있습니다: [app.roboflow.com](https://app.roboflow.com).

## 3. 확인

이 세션에 Roboflow 도구가 이미 로드된 경우가 아니라면 사용자에게 클라이언트를 다시 시작하라고 요청하세요. 그런 다음 `projects_list`를 호출하세요. 일부 클라이언트에서는 이름이 `mcp__roboflow__projects_list` 로 표시됩니다. 어떤 워크스페이스에서 응답했는지, 프로젝트가 몇 개인지 사용자에게 알려 주세요.

설정 파일만 보고 성공했다고 보고하지 마세요. 401 오류는 2단계가 완료되지 않았다는 뜻이고, 도구가 없으면 클라이언트가 다시 시작되지 않은 것입니다.

## OAuth를 사용할 수 없는 경우

CI 환경이나 구형 클라이언트처럼 OAuth를 사용할 수 없는 경우, 사용자에게 다음에서 `ROBOFLOW_API_KEY` 를 발급받아 [app.roboflow.com/settings/api](https://app.roboflow.com/settings/api) 다음 헤더와 함께 같은 URL에 전달하도록 안내하세요: `x-api-key` 헤더와 함께 `Accept: application/json, text/event-stream`. 사전 등록된 OAuth 앱이 필요한 게이트웨이는 [MCP 서버](/get-started/ko/agents/mcp-server.md#connecting-mcp-gateways-pre-registered-credentials) 페이지에서 설명합니다.
