내 AI에 AiAkiv 연결하기

Claude Web URL

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

Claude Desktop

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

파일 · .mcp.json

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

ChatGPT classic URL

① 커넥터는 앱에서 만들 수 없습니다. 브라우저로 chatgpt.com 에 접속해 웹페이지에서 추가하세요. ② 좌하단 사용자 클릭 → 설정 → 보안 및 로그인(Security and login) → ‘개발자 모드’를 켜세요. AiAkiv 가 OpenAI 플러그인 디렉터리에 등재되기 전이라 필요한 단계이고(2026-08 현재), 등재되면 없어집니다. 부담이라면 ChatGPT 카드의 폴더+키 방식으로 가세요. ③ 설정 → 앱(커넥터) → 앱 만들기 → 위 주소를 넣으세요. (Plus 이상) 한 번 만들면 ChatGPT 앱을 포함한 계정 전체에 적용됩니다. ④ 마지막으로, 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>"
      }
    }
  }
}

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": "<프로젝트-이름>"
      }
    }
  }
}

ChatGPT

ChatGPT app 자체는 OAuth를 사용할 수 없습니다. 폴더 프로젝트는 정적 API 키를 사용하여 설정할 수 있습니다. 콘솔에서 프로젝트별 API 키를 발급하고 설정 전체를 복사한 후, config.toml 에 붙여 넣으세요. Main 프로젝트와 무관하게 프로젝트가 고정됩니다. .codex/config.toml 을 수정했다면 저장 후 앱을 재시작하세요. ChatGPT classic 쪽 커넥터, ChatGPT 정적 키와 함께 사용해도 됩니다. 다만 이름은 겹치지 않게 두세요.

이 앱에서는 OAuth 가 붙지 않습니다. 커스텀 커넥터로도, 폴더 바인딩(X-K2G-Project 헤더)으로도 걸리지 않습니다. 그래서 헤더가 아니라 키로 고정합니다. ChatGPT classic 의 계정 커넥터와 함께 두어도 되지만, 서버 이름을 다르게 두어야 어느 쪽으로 저장할지 지목할 수 있습니다.

파일 · .codex/config.toml

[mcp_servers.AiAkiv-proj]
url = "https://mcp.aiakiv.com/mcp"
http_headers = { "Authorization" = "Bearer <API-KEY>" }

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>"
      }
    }
  }
}