> 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`. 다른 모든 클라이언트에서는 다음을 추가하세요 `roboflow` 를 MCP 설정에 다음과 같이: `{"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) 페이지에서 다룹니다.