Roboflow Agent 설정

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

코딩 에이전트를 위한 지침입니다. 사람이시라면, MCP 서버 를 읽으세요.

이 세션을 다음의 Roboflow MCP 서버에 연결하세요: https://mcp.roboflow.com/mcp. 두 단계는 당신이 아니라 사용자의 몫입니다: OAuth 로그인은 브라우저에서 이루어지고, 서버는 클라이언트가 재시작될 때만 로드됩니다. 당신의 역할을 수행한 뒤, 한 번에 한 가지 지침씩 전달하세요.

1. 서버 추가

다음 경우에는 건너뛰세요 roboflow 가 이미 다음에 표시됩니다 claude mcp list 또는 codex mcp list. 두 번 추가하지 마세요.

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.

3. 확인

이 세션에 이미 Roboflow의 도구가 로드되어 있지 않다면 클라이언트를 다시 시작하도록 요청하세요. 그런 다음 다음을 호출하세요 projects_list, 이름은 mcp__roboflow__projects_list 이며, 일부 클라이언트에서는 이렇게 표시됩니다. 어느 워크스페이스가 응답했는지와 그 안에 프로젝트가 몇 개 있는지 알려주세요.

구성 파일만 보고 성공했다고 보고하지 마세요. 401은 2단계가 아직 끝나지 않았음을 의미하며, 도구가 없다는 것은 재시작이 이루어지지 않았음을 의미합니다.

OAuth를 실행할 수 없는 경우

CI나 오래된 클라이언트처럼 OAuth를 실행할 수 없는 경우, 사용자가 다음을 내보내도록 하세요 ROBOFLOW_API_KEY 를 app.roboflow.com/settings/api 에서 내보내고, 이를 동일한 URL에 x-api-key 헤더로 전달하세요. 함께 Accept: application/json, text/event-stream. 사전 등록된 OAuth 앱이 필요한 게이트웨이는 MCP 서버 페이지에서 다룹니다.