내 AI에 AiAkiv 연결하기

Claude Web URL

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

Claude Desktop

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

파일 · .mcp.json

{
  "mcpServers": {
    "AiAkiv-myproject": {
      "type": "http",
      "url": "https://mcp.aiakiv.com/mcp?project=myproject",
      "headers": {
        "X-K2G-Project": "myproject"
      }
    }
  }
}

ChatGPT (플러그인) URL

① AiAkiv 는 OpenAI 플러그인 디렉터리에 등재돼 있어 앱에서 바로 설치합니다(주소를 손으로 넣지 않습니다). 설정 → Plugins → Browse directory(왼쪽 사이드바의 Plugins 로 가도 같은 화면)에서 검색창에 AiAkiv Memory 를 입력하세요. ② 결과를 누르고 Install plugin → www.aiakiv.com 계정으로 로그인하면 끝입니다. 계정 전체에 적용되어 ChatGPT classic 에서도 같이 보입니다. ③ 마지막으로, ChatGPT 는 플러그인을 대화마다 켜야 합니다. 새 대화 입력창 아래 Plugins 에서 AiAkiv Memory 를 켜고 @AiAkiv Memory 로 부르세요(설치 직후 뜨는 ‘Try now’ 를 누르면 이미 켜진 대화가 열립니다). 이 단계를 빼먹으면 새 대화에서 도구가 아예 보이지 않습니다. ChatGPT 플러그인 디렉터리의 공식 AiAkiv Memory 플러그인은 앱 기능(AI 에게 콘솔 관리 같은 앱 일을 시키는 기능)을 지원하지 않습니다. 콘솔 앱이 하는 일(팀 만들기와 초대, 팀 연결, 프로젝트와 페르소나, Main 바꾸기와 끄고 켜기, 만든 카드 관리 등)은 모두 웹 콘솔(대시보드, https://app.aiakiv.com)에 접속해 직접 할 수 있습니다. 앱 기능을 쓰려면 Codex 에 연결하거나(설치 프롬프트, www.aiakiv.com/docs/codex-install-prompt) 폴더에 프로젝트 고정 API 키로 연결하세요(아래 ‘폴더마다’ 의 ChatGPT 카드).

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-myproject": {
      "type": "http",
      "url": "https://mcp.aiakiv.com/mcp?project=myproject",
      "headers": {
        "X-K2G-Project": "myproject"
      }
    }
  }
}

Claude Code

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

파일 · .mcp.json

{
  "mcpServers": {
    "AiAkiv-myproject": {
      "type": "http",
      "url": "https://mcp.aiakiv.com/mcp?project=myproject",
      "headers": {
        "X-K2G-Project": "myproject"
      }
    }
  }
}

ChatGPT

플러그인으로 설치하면(위 ChatGPT (플러그인) 카드) 계정 전체가 Main 을 따릅니다. 폴더마다 프로젝트를 고정하고 싶을 때 이 방법을 씁니다. 콘솔에서 프로젝트별 API 키를 발급하고 설정 전체를 복사한 후, config.toml 에 붙여 넣으세요. Main 프로젝트와 무관하게 프로젝트가 고정됩니다. .codex/config.toml 을 수정했다면 저장 후 앱을 재시작하세요. 플러그인 설치, 다른 폴더의 정적 키와 함께 써도 됩니다. 폴더 쪽 서버 이름은 AiAkiv-<프로젝트 이름> 이라 겹치지 않습니다(아래 예시는 프로젝트 myproject — 콘솔에서 복사하면 내 프로젝트 이름이 들어 있습니다). 이 연결에는 앱 기능(AI 에게 콘솔 관리 같은 앱 일을 시키는 기능)이 있습니다. AI 에게 무언가를 바꾸는 콘솔 일을 시키려면 키를 발급할 때 ‘AI 콘솔 관리 허용 (manage)’ 를 체크하세요.

이 앱은 로그인(OAuth) 방식 폴더 바인딩(?project= 주소)이 걸리지 않습니다. 그래서 키로 고정합니다. 플러그인으로 설치한 계정 단위 연결과 함께 두어도 되고, 폴더 쪽 서버 이름이 AiAkiv-<프로젝트 이름> 으로 달라 어느 쪽으로 저장할지 지목할 수 있습니다.

파일 · .codex/config.toml

[mcp_servers.AiAkiv-myproject]
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-myproject": {
      "httpUrl": "https://mcp.aiakiv.com/mcp",
      "headers": {
        "Authorization": "Bearer <API-KEY>"
      }
    }
  }
}