에이전트가 직접
서버를 만들게
MCP 연동은 Claude Code·Cursor 같은 AI 에이전트가 퓨쳐인프라를 직접 다루게 하는 표준 연결입니다. 사람이 쓰는 것과 같은 REST API를 AI가 사용합니다. 권한과 월 한도는 키에 걸리고, 결제·동의·되돌릴 수 없는 작업은 브라우저에서 사람이 확인합니다.
Claude Code 연결
키를 복사하지 않습니다. MCP를 추가한 뒤 브라우저에서 로그인하거나 가입하면 됩니다.
claude mcp add --transport http futureinfra https://futureinfra.ai/v1/mcp
# Claude Code에서
/mcp
브라우저에서 권한을 승인하면 창이 닫히고 Claude가 중단했던 요청을 이어갑니다. 조직이 여럿이면 승인 화면에서 연결할 조직을 고릅니다. 연결한 뒤에는 AI에게 "마케팅 조직으로 바꿔 줘"라고 하면 다시 로그인하지 않고 바뀝니다.
API 키로 연결 (브라우저를 못 여는 환경·자동화·CI)
콘솔 → API 키에서 발급한 pk_live_ 키를 헤더로 넣습니다. 이 키는 비밀 키입니다.
claude mcp add --transport http --scope user futureinfra https://futureinfra.ai/v1/mcp --header "Authorization: Bearer 발급받은_키"
AI 에이전트에게 https://futureinfra.ai/llms.txt 주소와 키를 주면 위 명령을 안내합니다.
대부분의 AI는 비밀 키를 설정에 써넣는 일을 스스로 하지 않으므로, AI가 돌려준 명령을 터미널에 직접 붙여넣으세요.
조직이 여럿일 때
API 키는 발급한 조직 하나에만 묶입니다. 두 조직을 함께 쓰려면 조직마다 키를 받아 이름을 다르게 등록하세요. 같은 이름으로 등록하면 나중 것이 앞의 것을 덮어써서, AI가 엉뚱한 조직에서 일합니다.
claude mcp add --transport http --scope user futureinfra-onto https://futureinfra.ai/v1/mcp --header "Authorization: Bearer 온투_조직_키"
claude mcp add --transport http --scope user futureinfra-marketing https://futureinfra.ai/v1/mcp --header "Authorization: Bearer 마케팅_조직_키"
- AI는 연결될 때마다 지금 어느 조직에 붙었는지 안내받고, 만들기·지우기 전에 조직이 맞는지 확인합니다
- 브라우저 로그인으로 붙인 연결(Claude 앱 커넥터 등)은 한 번에 한 조직이며,
account.switch_org로 바꿉니다 - 이미
futureinfra가 등록돼 있는데 새 키를 받았다면, 지우기 전에 그 연결이 어느 조직인지 먼저 확인하세요
채팅에 붙여넣은 키
채팅에 붙여넣은 키는 노출된 것으로 봅니다. 일이 끝나면 AI가 스스로 폐기할 수 있습니다
(account.revoke_key, 인자 없이 부르면 지금 쓰는 키). 키는 자기 자신만 폐기할 수 있고,
다른 키는 콘솔에서 사람이 폐기합니다. 폐기해도 서버·앱 등 다른 자원은 그대로입니다.
도구 목록은 연결을 시작할 때 한 번만 읽어 갑니다. 그래서 서버에는 이미 올라가 있어도 실행 중인 창에는 안 보입니다 — 고장이 아니라 아직 못 본 것입니다.
브라우저 연결 흐름
비밀번호·개인정보·결제정보·장기 키를 AI 대화에 노출하지 않는 흐름입니다.
- 계정 확인AI가 기존 계정 여부를 묻습니다.
- 브라우저 인증사용자가 FutureInfra에서 직접 로그인하거나 가입합니다.
- 권한 확인필요한 스코프와 월 한도를 사용자가 승인합니다.
- 자동 재개창을 닫으면 AI가 중단했던 요청을 이어갑니다.
맡기기 전에 걸어둘 것
- 스코프를 좁히세요. 읽기만 필요하면
cloud:read만 주면 됩니다. - 한도를 거세요. 키마다 월 상한이 있어, 넘으면 호출이 거부됩니다.
- 삭제는 자동으로 안 됩니다. 되돌릴 수 없는 작업은 사람 승인을 거칩니다.
- 감사 로그를 보세요. 에이전트가 무엇을 했는지 전부 남습니다.
스코프
| 스코프 | 허용 범위 |
|---|---|
cloud:read | 서버·스냅샷·방화벽 조회 |
cloud:write | 생성·전원·스냅샷·포트 개방 (삭제는 승인 필요) |
domain:read / domain:write | 도메인 조회 / 변경 |
llm:* | AI 모델 호출 |
billing:read | 잔액·사용량 조회 |