내 AI에 AiAkiv 연결하기

Claude Web URL

설정 → 커넥터 → ‘+’ → 커스텀 커넥터 추가 → 위 주소를 넣으세요. (Pro/Max. 팀·기업은 소유자만, 설정 → 조직 설정 → 커넥터)

ChatGPT URL

① ChatGPT 앱과 ChatGPT classic 에서 추가하지 말고, 브라우저로 chatgpt.com 에 접속해 웹페이지에서 추가하세요. ② 좌하단 사용자 클릭 → 설정 → 보안 및 로그인(Security and login) → ‘개발자 모드’를 켜세요. ③ 설정 → 앱(커넥터) → 앱 만들기 → 위 주소를 넣으세요. (Plus 이상) 한 번 만들면 Codex 를 포함한 계정 전체에 적용됩니다. ④ 마지막으로, ChatGPT 는 커넥터를 대화마다 켜야 합니다 — 새 대화의 입력창에서 + 를 눌러 AiAkiv 를 고르세요(플러그인 창의 ‘채팅에서 사용해 보기’ 버튼을 누르면 이미 켜진 대화가 열립니다). 이 단계를 빼먹으면 새 대화에서 도구가 아예 보이지 않습니다.

xAI / Grok URL

grok.com/connectors → New Connector → Custom → 위 주소를 넣으세요.

Antigravity API key

Agent 패널의 ‘…’ → MCP Servers → Manage MCP Servers → View raw config 로 mcp_config.json 을 열고 아래 JSON 을 붙여넣으세요. 저장하면 자동으로 다시 읽습니다. (파일 위치: ~/.gemini/antigravity/mcp_config.json, 버전에 따라 ~/.gemini/config/mcp_config.json)

원격 서버 키는 반드시 serverUrl 입니다 — url·httpUrl·type 은 인식하지 않습니다(스키마가 엄격). 설정은 앱 전체 1개라 폴더별로 나눌 수 없어, 프로젝트는 키가 지정합니다: 콘솔에서 프로젝트별 API 키를 발급해 Authorization 헤더에 넣으세요(그 키가 프로젝트를 고정 → Main 무관).

파일 · mcp_config.json

{
  "mcpServers": {
    "AiAkiv": {
      "serverUrl": "https://mcp.aiakiv.com/mcp",
      "headers": {
        "Authorization": "Bearer <API-KEY>"
      }
    }
  }
}

Claude Desktop

앱 전체 = 왼쪽 아래 계정 → 설정 → 커넥터 → 커스텀 커넥터 추가 → 위 주소 입력. 폴더 = 작업 폴더에 .mcp.json 을 만들고 아래 JSON 을 붙여넣으세요.

파일 · .mcp.json

{
  "mcpServers": {
    "AiAkiv": {
      "type": "http",
      "url": "https://mcp.aiakiv.com/mcp",
      "headers": {
        "X-K2G-Project": "<프로젝트-이름>"
      }
    }
  }
}

Cursor

앱 전체 = 설정(Ctrl/Cmd+,) → Tools & MCP → + Add New MCP Server → Transport 를 streamable-http 로 바꾸고 위 주소 입력. 폴더 = 작업 폴더에 .cursor 폴더를 만들고 mcp.json 에 아래 JSON 을 붙여넣으세요.

파일 · .cursor/mcp.json

{
  "mcpServers": {
    "AiAkiv": {
      "type": "http",
      "url": "https://mcp.aiakiv.com/mcp",
      "headers": {
        "X-K2G-Project": "<프로젝트-이름>"
      }
    }
  }
}

Claude Code

작업하는 폴더에 .mcp.json 파일을 만들고 아래 JSON 을 붙여넣으세요.

파일 · .mcp.json

{
  "mcpServers": {
    "AiAkiv": {
      "type": "http",
      "url": "https://mcp.aiakiv.com/mcp",
      "headers": {
        "X-K2G-Project": "<프로젝트-이름>"
      }
    }
  }
}

Gemini CLI API key

작업 폴더에 .gemini 폴더를 만들고 settings.json 에 아래 API 키 설정을 붙여넣으세요. 키는 콘솔에서 프로젝트별로 발급합니다(1회 노출).

Gemini CLI 는 로그인 연결이 오래 유지되지 않습니다. 꼭 API 키 방식으로 연결하세요.

파일 · .gemini/settings.json

{
  "mcpServers": {
    "AiAkiv": {
      "httpUrl": "https://mcp.aiakiv.com/mcp",
      "headers": {
        "Authorization": "Bearer <API-KEY>"
      }
    }
  }
}