---
title: "ChatGPT"
description: "개발자 모드로 TwexAPI를 ChatGPT에 연결하고 TwexAPI 계정으로 로그인해 X 게시물, 프로필, 팔로워, 트렌드를 검색합니다."
---

ChatGPT는 `https://api.twexapi.io/mcp`의 TwexAPI MCP 서버에 연결하고 TwexAPI 계정으로 로그인합니다. ChatGPT는 커스텀 헤더를 보낼 수 없으므로 API 키를 사용하지 않으며, 모든 연결은 로그인 페이지를 거칩니다. 호출은 TwexAPI 크레딧을 사용합니다.

## 준비 사항

- 개발자 모드(Developer mode). ChatGPT가 직접 만든 MCP 서버에 연결할 수 있게 해 줍니다. OpenAI는 일부 플랜에서만 제공하며 워크스페이스 관리자가 제한할 수도 있습니다. 찾을 수 없다면 [OpenAI의 개발자 모드 가이드](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)에서 계정이 대상인지 확인하세요.
- 활성 API 키와 크레딧이 있는 TwexAPI 계정. 키는 [TwexAPI 대시보드](https://twexapi.io/dashboard)에서 만듭니다.

:::note
  OpenAI는 이 설정의 위치를 가끔 바꿉니다. 아래 메뉴 이름이 화면과 다르면 OpenAI의 최신 가이드를 따르세요. 서버 URL과 로그인 단계는 그대로입니다.
:::

## 웹 버전 ChatGPT

1. **개발자 모드 켜기**

    **Settings**를 열고 **Developer mode**를 켭니다. 최신 버전에서는 **Security and login** 아래에, 이전 버전에서는 **Connectors → Advanced settings** 아래에 있습니다.

2. **TwexAPI 추가**

    **Plugins**(또는 **Apps**)를 열고 **+**를 선택해 커스텀 MCP 서버를 추가합니다. 이름에 `TwexAPI`, URL에 `https://api.twexapi.io/mcp`를 입력합니다. 인증 방식을 물으면 **OAuth**를 선택하고 생성합니다.

3. **로그인**

    ChatGPT가 TwexAPI 로그인 페이지를 엽니다. 로그인하고 ChatGPT의 게시 허용 여부를 선택한 뒤 **Approve**를 선택합니다.

4. **채팅에서 사용**

    새 채팅을 시작하고 **+** 메뉴나 `@` 입력으로 TwexAPI를 선택한 뒤 작업을 설명합니다.

## ChatGPT 데스크톱 앱

1. **커스텀 MCP 양식 열기**

    앱 설정을 열고 커스텀 MCP 서버 연결을 선택합니다.

2. **Streamable HTTP 선택**

    이름에 `TwexAPI`를 입력하고 유형을 **STDIO**에서 **Streamable HTTP**로 바꿉니다. URL에 `https://api.twexapi.io/mcp`를 입력합니다. 토큰, 헤더, 환경 변수 필드는 모두 비워 두고 저장합니다.

3. **로그인**

    브라우저에서 TwexAPI 로그인 페이지가 열립니다. **Approve**를 선택하면 인증이 완료되었다는 `127.0.0.1` 페이지가 표시됩니다. 데스크톱 앱은 이 로컬 주소로 결과를 받습니다. 창을 닫고 ChatGPT로 돌아가세요.

## 도구

ChatGPT에서 보이는 도구는 다른 클라이언트와 같습니다.

| 도구 | 기능 |
| --- | --- |
| `explore` | 작업에 맞는 엔드포인트와 입력을 찾습니다. 크레딧을 사용하지 않습니다. |
| `twexapi_request` | X 데이터를 읽습니다: 검색, 트윗, 답글, 스레드, 프로필, 팔로워, 커뮤니티, 리스트, 트렌드. |
| `twexapi_write` | 트윗 또는 답글을 게시합니다. 쓰기 권한을 허용한 경우에만 표시되며, ChatGPT가 매번 확인합니다. |

게시하려면 게시할 계정의 X 쿠키가 필요하고, 쿠키는 ChatGPT 대화를 거칩니다. ChatGPT를 읽기 전용으로 쓰려면 로그인 페이지에서 쓰기 체크를 해제하세요.

자세한 내용은 [MCP 도구 레퍼런스](/mcp/tools)를 참고하세요.

## 크레딧

각 호출의 비용은 해당하는 REST 요청과 같습니다. 잔액이 소진되어도 연결은 유지되며 ChatGPT가 "No credits left on this TwexAPI account"라고 알려 줍니다. [대시보드](https://twexapi.io/dashboard)에서 충전한 뒤 다시 요청하세요.

## 문제 해결

| 문제 | 해결 방법 |
| --- | --- |
| 개발자 모드나 추가 버튼이 없음 | 플랜이나 워크스페이스 관리자가 커스텀 MCP 서버를 허용하지 않았을 수 있습니다. OpenAI 가이드를 확인하세요. |
| 로그인이 실패하거나 반복됨 | ChatGPT에서 TwexAPI를 삭제하고 다시 추가한 뒤 로그인합니다. |
| 로그인 페이지에 API 키나 크레딧이 없다고 표시됨 | 대시보드에서 해결한 뒤 10분 안에 다시 **Approve**를 선택합니다. |
| 도구가 빠져 있음 | ChatGPT에서 커넥터를 새로 고칩니다. `twexapi_write`가 없다면 읽기 전용으로 연결한 것입니다. |
| 연결을 해제하고 싶음 | 대시보드의 **Authorized apps**(승인된 앱)에서 ChatGPT를 취소하고 ChatGPT에서도 커넥터를 삭제합니다. |

예전 가이드에서는 Custom GPT와 OpenAPI Action을 사용하는 방법을 안내했습니다. 이 방법은 지금도 API 키로 REST API를 호출할 때 사용할 수 있지만, MCP 서버를 사용할 때는 개발자 모드와 로그인 조합이 권장 방법입니다.