App Factory에서 에이전트 연결 화면을 열고, 내 에이전트를 고른 뒤 그 페이지의 안내를 따르세요: Apiway 커넥터를 추가하고, Apiway에 로그인하고, Allow 버튼을 클릭합니다. 페이지가 저절로 “연결됨” 상태로 바뀌고, 그때부터 에이전트가 그 Apiway 계정의 앱을 볼 수 있습니다.
단계
- 에이전트 연결 열기App Factory에서 에이전트 연결 화면을 여세요. ChatGPT Work, Claude, Gemini, Claude Code, Codex, Cursor, DeepSeek Harness가 나열되어 있고, 연결된 에이전트에는 연결됨 표시가 붙어 있습니다. — Apiway에서 열기
- 에이전트 고르기이미 쓰고 있는 것을 고르세요. 코딩 에이전트는 내 컴퓨터에서 실행되고, ChatGPT와 Claude는 채팅 안에서 바로 앱을 작성합니다.
- 페이지의 안내 따르기에이전트 페이지에 번호가 붙은 단계와 커넥터 주소가 나와 있습니다. 같은 단계를 아래에 에이전트별 섹션으로 정리했습니다.
- 확인페이지가 저절로 연결됨 상태로 바뀝니다. 채팅에서 이렇게 물어보세요: “Apiway에 연결되어 있어? Apiway 계정 이름을 말하고 내 앱 목록을 보여 줘.”
ChatGPT Work 연결하기
- 1단계ChatGPT에서 Apiway 플러그인을 열고 Connect를 누르세요: https://chatgpt.com/plugins/plugin_asdk_app_6ac1b80c1e7c8191ab90cb41923ce43d
- 2단계Apiway에 로그인하고 허용을 클릭하세요.
- 3단계그다음 새 채팅을 시작하세요 — 열린 채팅은 도구 목록을 다시 읽지 않아요.
- 4단계채팅에서 연결 확인: Apiway에 연결되어 있나요? Apiway 계정 이름을 알려 주고 내 앱 목록을 보여 줘.
- 5단계ChatGPT 상단의 “Work” 탭을 사용하세요 — Chat보다 작업을 훨씬 잘해요.
- 6단계플러그인이 열리지 않으면(플러그인이 꺼진 회사 계정): Add → Add custom MCP server를 누르고 이름을 Apiway로 정한 뒤 Connection에 이 주소를 붙여 넣으세요: https://apiway.ai/api/mcp
Claude 연결하기
- 1단계Claude 열기 → Customize → Connectors.
- 2단계+ Add → Add custom connector를 누르고 이름을 Apiway로 정한 뒤 이 주소를 붙여 넣으세요: https://apiway.ai/api/mcp
- 3단계Apiway에 로그인하고 허용을 클릭하세요.
- 4단계Apiway 도구 허용: Claude에서 Customize → Connectors → Yours → Apiway → Tool permissions를 열고 세 그룹 모두(Interactive, Read-only, Write/delete)에 “Always allow”(또는 “Needs approval”)를 고르세요.
- 5단계그다음 새 채팅을 시작하세요 — 열린 채팅은 도구 목록을 다시 읽지 않아요.
- 6단계채팅에서 연결 확인: Apiway에 연결되어 있나요? Apiway 계정 이름을 알려 주고 내 앱 목록을 보여 줘.
Gemini 연결하기
- 1단계Gemini → Customize → Connectors 열기.
- 2단계+ Custom을 누르고 이 주소를 MCP Server URL에 붙여넣으세요: https://apiway.ai/api/mcp
- 3단계Next를 누르고 「I understand and accept the security and privacy risks」에 체크한 뒤 Connect, 이어서 Agree and continue를 누르세요.
- 4단계Apiway에 로그인하고 허용을 클릭하세요.
- 5단계Gemini로 돌아가 Connect를 눌러 Apiway를 저장하세요.
- 6단계그다음 새 채팅을 시작하세요 — 열린 채팅은 도구 목록을 다시 읽지 않아요.
- 7단계채팅에서 연결 확인: Apiway에 연결되어 있나요? Apiway 계정 이름을 알려 주고 내 앱 목록을 보여 줘.
Claude Code 연결하기
- 1단계Claude Code 설치. Claude 데스크톱 앱(또는 터미널의 Claude Code)을 설치하고 Claude 계정으로 로그인하세요.
- 2단계터미널에서 한 번 실행하세요: claude mcp add --scope user --transport http apiway https://apiway.ai/api/mcp
- 3단계Apiway에 로그인. 그다음 Claude Code에서 /mcp를 입력하고 apiway → Authenticate를 선택한 뒤, Apiway에 로그인하고 Allow를 클릭하세요.
- 4단계그다음 새 채팅을 시작하세요 — 열린 채팅은 도구 목록을 다시 읽지 않아요.
Codex 연결하기
- 1단계Codex 설치. Codex 앱(또는 Codex CLI)을 설치하고 ChatGPT 계정으로 로그인하세요.
- 2단계Codex에서 Customize → Plugins를 열고 Apiway를 검색한 뒤 «Apiway — AI Workspace» 옆의 +를 누르세요.
- 3단계Apiway에 로그인하고 허용을 클릭하세요.
- 4단계대신 터미널에서: 터미널에서 한 번 실행하세요 — Apiway가 추가되고 로그인 화면이 열려요: codex mcp add apiway --url https://apiway.ai/api/mcp && codex mcp login apiway
- 5단계그다음 새 채팅을 시작하세요 — 열린 채팅은 도구 목록을 다시 읽지 않아요.
- 6단계새 채팅에 Apiway가 없으면 Codex를 종료(⌘Q)했다가 다시 여세요.
Cursor 연결하기
- 1단계Cursor 설치. cursor.com에서 Cursor를 다운로드하고, 열어서 로그인하세요.
- 2단계Cursor에 Apiway 추가: Apiway에서 /app/app-factory/agents/cursor 페이지를 열고 Cursor에 추가 버튼을 누르세요.
- 3단계Apiway에 로그인. Cursor가 열리고 Apiway 설치를 요청해요 — 설치를 누른 뒤 연결을 누르고, Apiway에 로그인한 다음 허용을 클릭하세요.
- 4단계그다음 새 채팅을 시작하세요 — 열린 채팅은 도구 목록을 다시 읽지 않아요.
DeepSeek Harness 연결하기
- 1단계DeepSeek Harness 설치. deepseek.com/harness에서 DeepSeek Harness를 다운로드하고, 열어서 로그인하세요.
- 2단계DeepSeek Harness에 Apiway 추가: Apiway에서 /app/app-factory/agents/deepseek 페이지를 여세요. 페이지에 터미널 명령 하나와 ~/.dsh/profiles/web/cordis.patch.yml 파일에 넣을 줄이 나와 있습니다.
- 3단계Apiway에 로그인. DeepSeek Harness를 다시 시작하세요. 브라우저 탭이 열리면 Apiway에 로그인하고 허용을 클릭하세요.
- 4단계그다음 새 채팅을 시작하세요 — 열린 채팅은 도구 목록을 다시 읽지 않아요.
에이전트 목록
| 에이전트 | 필요한 것 |
|---|---|
| ChatGPT Work | 모든 ChatGPT 요금제: Apiway는 ChatGPT 플러그인 디렉터리에 있어요. 채팅에서 작동하며 설치할 것이 없어요 |
| Claude | claude.ai의 Claude 계정. 채팅에서 동작하며 설치할 것이 없습니다 |
| Gemini | gemini.google.com의 Google 계정. 채팅에서 동작하며 설치할 것이 없습니다 |
| Claude Code | Claude Pro 또는 Max 구독. 내 컴퓨터에서 실행됩니다 |
| Codex | ChatGPT Plus 또는 Pro 구독. 내 컴퓨터에서 실행됩니다 |
| Cursor | 설치된 Cursor. 무료 플랜이 있습니다. 내 컴퓨터에서 실행됩니다 |
| DeepSeek Harness | DeepSeek 계정. 내 컴퓨터에서 실행됩니다 |
| 커넥터 이름 | Apiway |
| 커넥터 주소 | https://apiway.ai/api/mcp |
잘 안 될 때
- 에이전트가 연결되었는데 내 앱을 보지 못할 때: 다른 Apiway 계정으로 로그인되어 있습니다. 에이전트의 커넥터 설정에서 Apiway 연결을 해제하고, 앱 소유자 계정으로 apiway.ai에 로그인한 뒤 다시 연결하고 새 채팅을 시작하세요.
- Claude가 Apiway 도구가 보이지 않는다고 할 때: Claude에서 Settings → Connectors → apiway.ai → Tool permissions를 열고 세 그룹 모두 “Always allow”를 고른 뒤 새 채팅을 시작하세요.
- ChatGPT에서 Apiway 플러그인이 열리지 않아요: 회사 계정에서는 관리자가 플러그인을 꺼 둘 수 있어요. 관리자에게 요청하거나 주소로 Apiway를 연결하세요: Plugins → Add → Add custom MCP server.
질문과 답변
에이전트를 연결하면 Apiway 크레딧이 드나요?
아니요. 에이전트는 해당 에이전트의 내 구독으로 동작합니다.
에이전트 하나로 Apiway 계정 두 개를 쓸 수 있나요?
에이전트는 커넥터를 허용할 때 로그인되어 있던 계정을 봅니다. 다른 계정으로 다시 연결하거나, 에이전트가 허용하는 경우 두 번째 연결을 추가하세요.