DOC › IBIGENT Studio

IBIGENT Studio 연동

API도 코딩도 없이, AI 도구에서 만든 HTML을 복사·붙여넣기 없이 IBIGENT Studio 편집 화면으로 바로 받습니다. AI에게 아이비전트 코드로 보내줘 라고 말하면 편집 화면 원하는 위치에 그대로 들어옵니다.

AI 도구용 마크다운(.md) 원문 보기

도구별 문서

MCP 연결 (전체)키 발급부터 모든 도구 등록·전송까지 한 페이지 Claude CodeAnthropic — claude mcp add / .mcp.json Cursor설정 화면 / ~/.cursor/mcp.json / 원클릭 CodexOpenAI — codex mcp add / config.toml AntigravityGoogle — mcp_config.json (serverUrl)

1. 키 발급 (처음 한 번)

마이페이지 > AI 연동 > 연동 키 관리 로 이동합니다.

[키 발급] 을 누르면 전용 키 ibg_… 가 생성됩니다. 키는 비밀번호와 같으니 노출 금지. 원문은 발급 직후 한 번만 표시됩니다.

2. MCP 연결 (사용하는 AI 도구에 등록)

AI 도구에 아래 서버 주소를 등록합니다. <내_키> 자리에 발급받은 키를 넣으세요.

https://mcp.ibigent.com/mcp/<내_키>

Claude Code Anthropic

명령어 (권장)

터미널에 붙여넣고 실행:

claude mcp add --transport http ibigent https://mcp.ibigent.com/mcp/<내_키>

설정 파일

작업 폴더의 .mcp.json (전체 적용은 홈의 ~/.claude.json):

{
  "mcpServers": {
    "ibigent": { "type": "http", "url": "https://mcp.ibigent.com/mcp/<내_키>" }
  }
}

등록 확인: claude mcp list 에 ibigent 이 보이면 완료.

Cursor

설정 화면

설정(⚙) > Tools & Integrations > Add custom MCP. 종류 HTTP(URL), 이름 ibigent, 주소:

https://mcp.ibigent.com/mcp/<내_키>

설정 파일

~/.cursor/mcp.json (Windows: C:\Users\사용자\.cursor\mcp.json):

{
  "mcpServers": {
    "ibigent": { "url": "https://mcp.ibigent.com/mcp/<내_키>" }
  }
}

마이페이지에서 키 발급 시 Cursor 앱 1-클릭 등록 딥링크도 지원됩니다.

Codex OpenAI

명령어

터미널에 붙여넣고 실행:

codex mcp add ibigent --url https://mcp.ibigent.com/mcp/<내_키>

설정 파일

~/.codex/config.toml (Windows: C:\Users\사용자\.codex\config.toml):

[mcp_servers.ibigent]
url = "https://mcp.ibigent.com/mcp/<내_키>"

표 이름은 밑줄·복수형 [mcp_servers.ibigent]. transport·type 키는 금지(오류).

확인: codex mcp list 에 ibigent 표시.

Antigravity Google

설정 파일

에이전트 패널 ··· > MCP Servers > View raw config 로 열어 ~/.gemini/config/mcp_config.json (Windows: C:\Users\사용자\.gemini\config\mcp_config.json) 에 추가 후 Refresh:

{
  "mcpServers": {
    "ibigent": { "serverUrl": "https://mcp.ibigent.com/mcp/<내_키>" }
  }
}

원격 서버는 반드시 키 이름 serverUrl — url·httpUrl 은 인식되지 않습니다(조용히 실패).

등록 후 도구는 처음엔 “확인 요청(Ask)” 상태 — 한 번 허용하면 됩니다.

3. HTML 전송 (사용할 때마다)

편집 화면 우측 아래 [AI 연동] 을 펼쳐 6자리 코드를 확인합니다. (코드는 편집 화면에서만 표시되고 10분마다 갱신)

AI 도구에게 이렇게 말합니다(“아이비전트” + 코드 필수):

이 HTML을 아이비전트 ABC123 으로 보내줘

HTML을 직접 줘도 되고, “회사 소개 섹션 만들어서 아이비전트 ABC123 으로 보내줘” 처럼 생성도 가능합니다.

2~3초 뒤 편집 화면에 자동 삽입 → 확인 후 [패치 적용] 으로 저장. (저장 전까지 실제 사이트에 미반영)

참고 · 삽입 방식: 기본은 “뒤에 추가”, “맨 앞에” → 위쪽, “교체” → 전체 교체. · 코드는 10분 뒤 만료(다시 펼치면 새 코드). · 키는 계정당 여러 개 발급 가능, 노출 시 폐기 후 재발급. · 보안을 위해 <script>·<iframe> 등 외부 삽입 태그는 서버에서 자동 제거됩니다.

제품 소개: IBIGENT Studio · 실제 키 발급: 마이페이지 > AI 연동