ChatGPT

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

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

준비 사항

개발자 모드(Developer mode). ChatGPT가 직접 만든 MCP 서버에 연결할 수 있게 해 줍니다. OpenAI는 일부 플랜에서만 제공하며 워크스페이스 관리자가 제한할 수도 있습니다. 찾을 수 없다면 OpenAI의 개발자 모드 가이드에서 계정이 대상인지 확인하세요.
활성 API 키와 크레딧이 있는 TwexAPI 계정. 키는 TwexAPI 대시보드에서 만듭니다.

웹 버전 ChatGPT

개발자 모드 켜기

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

TwexAPI 추가

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

로그인

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

채팅에서 사용

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

ChatGPT 데스크톱 앱

커스텀 MCP 양식 열기

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

Streamable HTTP 선택

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

로그인

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

도구

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

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

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

자세한 내용은 MCP 도구 레퍼런스를 참고하세요.

크레딧

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

문제 해결

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

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