--- title: "MCP 서버" description: "Model Context Protocol을 통해 AI 에이전트를 Twexapi에 연결합니다." --- # MCP를 통해 AI 에이전트 연결 Twexapi는 AI 에이전트 및 개발 도구가 프로그래밍 방식으로 Twexapi 계정과 상호 작용할 수 있게 해주는 [모델 컨텍스트 프로토콜](https://modelcontextprotocol.io) 서버를 실행합니다. 이 페이지에서는 인증된 API 작업을 위한 `https://api.twexapi.io/mcp`의 API MCP 서버를 다룹니다. 읽기 전용 문서 검색의 경우 `https://docs.twexapi.io/mcp`에서 [Docs MCP 서버](/mcp/docs-mcp)를 사용하세요. ## 연결 ### 규약 MCP 클라이언트를 위한 스트리밍 가능한 HTTP 전송이 포함된 HTTP입니다. ### 엔드포인트 클라이언트를 다음 URL에 연결합니다. ```txt https://api.twexapi.io/mcp ``` API 서버는 `https://api.twexapi.io/mcp`와 `https://api.twexapi.io/mcp/`를 모두 허용합니다. 클라이언트가 명시적으로 정규화하지 않는 한 클라이언트 구성에서 슬래시가 없는 URL을 사용하세요. ### 인증 작업공간에 OAuth가 활성화된 경우 `x-api-key`의 Twexapi API 키 또는 OAuth 2.1 Bearer 토큰을 사용하세요. MCP 서버 검색 메타데이터는 다음 위치에서 확인할 수 있습니다. ```txt https://api.twexapi.io/.well-known/mcp.json ``` `GET /.well-known/mcp.json`은 MCP 레지스트리 서버 카드 JSON을 직접 반환합니다. `GET /.well-known/mcp/server-card.json`은 중첩된 서버 카드 경로를 읽는 클라이언트에 대해 동일한 카드를 반환합니다. 레지스트리 카드 클라이언트는 API 키 인증을 통해 `https://api.twexapi.io/mcp`에 대한 `streamable-http` 원격을 수신합니다. 아래의 직접 클라이언트 예시는 클라이언트가 사용자 정의 헤더를 지원할 때 'x-api-key'와 동일한 키를 보낼 수 있습니다. :::note API 키 클라이언트는 첫 번째 요청 시 `x-api-key`를 보내야 합니다. `https://api.twexapi.io/mcp`에 대한 인증되지 않은 요청은 `401`을 반환합니다. ::: ## 입증 MCP 서버는 다음과 같은 인증 방법을 지원합니다. - API 키(`x-api-key` 헤더): 원격 브리지를 통해 Claude Code, Cursor, VS Code, Windsurf, Codex CLI, OpenCode 및 Claude Desktop에서 사용됩니다. MCP 핸드셰이크 중에 키를 전달합니다. - Bearer 토큰(`Authorization: Bearer `): Authorization 헤더를 선호하는 클라이언트가 사용합니다. 이는 Twexapi API 키일 수도 있고 OAuth가 활성화된 경우 OAuth 토큰일 수도 있습니다. [Twexapi 대시보드](https://twexapi.io/dashboard)에서 API 키를 생성하세요. ## 작동 원리 MCP 서버는 두 가지 도구를 노출합니다. ### `explore` Twexapi API 카탈로그를 검색하세요. 이는 검색 도구입니다. 엔드포인트 이름, 메서드, 경로, 범주, 매개 변수 스키마, 예제 및 안전 플래그를 반환합니다. ### `twexapi_request` 인증된 Twexapi API 호출을 실행합니다. 비용은 기본 엔드포인트를 따릅니다. 에이전트는 먼저 `explore`로 검색한 다음 반환된 메서드와 상대 경로를 사용하여 `twexapi_request`를 호출합니다. 인증은 MCP 요청에서 자동으로 주입됩니다. ### '탐색' 도구 인메모리 API 엔드포인트 카탈로그를 검색합니다. 호출에는 여전히 API 키 또는 Bearer 토큰을 통한 MCP 인증이 필요합니다. ```ts interface EndpointInfo { name: string; method: string; path: string; category: string; // trending, search, users, tweets, followers, engagement, communities, lists, dm, articles, timeline, accounts, write description: string; read_only: boolean; parameters_schema?: Record; example?: Record; } ``` ### `twexapi_request` 도구 허용 목록에 있는 Twexapi REST 엔드포인트에 대해 API 호출을 실행합니다. ```ts declare const twexapi_request: { method: string; path: string; query?: Record; body?: unknown; }; ``` 호출 예시: ```json { "method": "GET", "path": "/twitter/global-trending/countries" } ``` ## MCP 대 REST API ### MCP 서버 AI 에이전트, IDE 통합 및 자연어 워크플로에 가장 적합합니다. `x-api-key` 또는 Bearer 인증을 사용하여 `https://api.twexapi.io/mcp`에 연결합니다. 에이전트는 엔드포인트 검색에 'explore'를 사용하고 인증된 API 호출에 'twexapi_request'를 사용합니다. ### REST API 백엔드 서비스, 자동화 스크립트 및 직접 프로그래밍 방식 액세스에 가장 적합합니다. `Authorization: Bearer `을 사용하여 `https://api.twexapi.io/*`를 호출합니다. 엔드포인트, 페이지 매김, 응답 처리 또는 직접 SDK 코드에 대한 세부적인 제어가 필요한 경우 API 참조를 사용하세요. 에이전트가 자연어를 통해 X/Twitter 데이터와 상호 작용하도록 하려면 MCP를 사용하십시오. 프로덕션 백엔드, 예약된 작업 또는 직접 통합을 구축하는 경우 REST를 사용하세요. ## 설정 ### 웹 및 터미널 클라이언트 - [클로드.ai](#claude-ai) - [클로드 데스크탑](#claude-desktop) - [클로드코드](#claude-code) - [코덱스 CLI](#codex-cli) #### 클로드.ai Claude.ai는 작업 공간에 대해 MCP 커넥터가 활성화되면 원격 MCP 서버에 연결할 수 있습니다. 서버 URL로 `https://api.twexapi.io/mcp`를 사용합니다. OAuth 지원 작업공간은 브라우저에서 인증을 완료할 수 있습니다. API 키 클라이언트는 `x-api-key`를 사용해야 합니다. #### 클로드 데스크탑 Claude Desktop은 stdio 전송만 지원합니다. 'mcp-remote' npm 패키지를 브리지로 사용합니다. ```json { "mcpServers": { "twexapi": { "command": "npx", "args": [ "mcp-remote@latest", "https://api.twexapi.io/mcp", "--header", "x-api-key:twexapi_YOUR_KEY_HERE" ] } } } ``` #### 클로드 코드 `.mcp.json`에 추가합니다. ```json { "mcpServers": { "twexapi": { "type": "http", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### 코덱스 CLI `~/.codex/config.toml`에 추가: ```toml [mcp_servers.twexapi] url = "https://api.twexapi.io/mcp" http_headers = { "x-api-key" = "twexapi_YOUR_KEY_HERE" } ``` ### 편집자 클라이언트 - [커서](#cursor) - [VS 코드](#vs-code) - [윈드서핑](#windsurf) - [오픈코드](#opencode) #### 커서 `~/.cursor/mcp.json`(전역) 또는 `.cursor/mcp.json`(프로젝트)에 추가합니다. ```json { "mcpServers": { "twexapi": { "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### VS 코드 `.vscode/mcp.json`(프로젝트)에 추가하거나 **MCP: 사용자 구성 열기**(전역)를 사용합니다. ```json { "servers": { "twexapi": { "type": "http", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### 윈드서핑 `~/.codeium/windsurf/mcp_config.json`에 추가: ```json { "mcpServers": { "twexapi": { "serverUrl": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### 오픈코드 `opencode.json`에 추가: ```json { "mcp": { "twexapi": { "type": "remote", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` ### 채팅GPT ChatGPT를 Twexapi에 연결하는 방법에는 3가지가 있습니다. **옵션 1: 맞춤 GPT** API 배포에서 OpenAPI 스키마를 사용하여 사용자 정의 GPT를 생성하고 Twexapi를 작업으로 추가합니다. 설정에 따라 인증을 API 키 헤더 또는 Bearer 토큰으로 설정하세요. **옵션 2: 에이전트 SDK** 에이전트 런타임에서 스트리밍 가능한 HTTP MCP를 사용합니다. ```python from agents.mcp import MCPServerStreamableHttp async with MCPServerStreamableHttp( url="https://api.twexapi.io/mcp", headers={"x-api-key": "twexapi_YOUR_KEY_HERE"}, params={}, ) as twexapi: # use Twexapi as a tool provider pass ``` **옵션 3: 개발자 모드** ChatGPT 환경이 MCP 커넥터를 지원하는 경우 'https://api.twexapi.io/mcp'를 엔드포인트로 사용하여 Twexapi를 추가하세요. OAuth 지원 작업공간은 브라우저에서 인증을 완료할 수 있습니다. ## 예시 프롬프트 연결되면 AI 에이전트에 다음과 같은 질문을 할 수 있습니다. ### 검색 및 조회 - 지난 24시간 동안 'AI 에이전트'에 대한 최근 X 게시물을 검색하세요. 트윗 ID, 작성자, 생성 시간, 좋아요, 재게시물 및 한 줄 요약이 포함된 상위 20개 트윗을 반환합니다. - `Grok` 또는 `AI`를 언급한 `@elonmusk`의 최근 트윗을 찾아보세요. 주제별로 결과를 그룹화하고 직접 X 링크를 포함합니다. - 이 트윗을 읽어보세요: `https://x.com/elonmusk/status/1803006263529541838`. 게시물을 요약한 다음 가장 관련성이 높은 답변을 가져와 답변 ID를 표시합니다. - 트윗 ID '1803006263529541838'에 대한 유사한 트윗을 받고 각 결과가 서로 관련된 이유를 설명하세요. ### 사용자 프로필 및 팔로우 - `@openai` 프로필 약력을 읽고 사용자 이름, 표시 이름, 사용자 ID, 위치, 팔로어 수 및 프로필 URL을 반환합니다. - X 사용자에게 'AI 인프라'를 검색하세요. 사용자 이름, 약력, 팔로어 수 및 일치 이유가 포함된 25개의 계정을 반환합니다. - `@elonmusk`의 최신 팔로어를 확보한 다음 바이오스에서 AI, 스타트업 또는 암호화폐를 언급하는 계정을 식별하세요. - `@sama`에 대해 커서 페이지가 매겨진 팔로어 페이지 하나를 가져와 처음 20명의 사용자를 반환하고 다음 실행을 위해 `next_cursor`를 보존합니다. - '44196397', 'elonmusk', 'openai' 계정이 인증되었거나 조직과 연계되어 있는지 확인하세요. ### 동향 - 지원되는 모든 글로벌 트렌드 국가를 표시한 다음 '미국'에 대한 상위 트렌드 주제를 가져옵니다. - '기술' 주제와 콘텐츠 태그 'AI'를 사용하여 '미국'에 대한 인기 트윗을 가져옵니다. 트윗 ID, 작성자 및 참여 지표를 반환합니다. - 요즘 미국에서 'AI', 'Bitcoin', 'Grok'이 유행하고 있는지 확인해보세요. 반환된 트윗의 증거를 설명하세요. - '미국', '일본', '영국'의 인기 주제를 비교하고 지역별 차이점을 요약합니다. ### 추출 - 답글을 `https://x.com/elonmusk/status/1803006263529541838`로 가져와 관련성에 따라 정렬하고 답글 ID, 작성자, 텍스트 및 좋아요 수를 반환합니다. - 트윗 ID `1803006263529541838`을 리트윗한 사용자 50명을 나열합니다. 가능한 경우 사용자 ID, 사용자 이름, 표시 이름 및 팔로어 수를 반환합니다. - 트윗 ID '1803006263529541838'에 대한 인용 트윗을 가져온 다음 인용문을 지지, 비판, 중립으로 분류하세요. - 트윗 ID '1803006263529541838'에 대한 전체 스레드를 추출하여 Markdown 개요로 변환합니다. - '@elonmusk'에 대한 모든 트윗과 답글을 '20'으로 가져온 다음 원본 게시물과 답글을 분리하세요. ### 조항 - X 기사 '1803006263529541838'을 Markdown으로 가져와서 5개의 글머리 기호로 구성된 경영진 브리핑으로 변환합니다. - ID가 '1803006263529541838' 및 '1803006263529541839'인 기사 X개를 일괄 가져옵니다. 제목, 작성자, 게시 시간 및 요약을 반환합니다. - 이 X 기사를 Markdown으로 읽고, 모든 링크를 추출하고, 깔끔한 뉴스레터 스타일 요약을 생성하세요. ### 커뮤니티 및 목록 - X 커뮤니티에서 `AI 빌더`를 검색하세요. 커뮤니티 ID, 이름, 회원 수 및 설명을 반환합니다. - 트윗 유형이 'Latest'이고 대상 개수가 '20'인 커뮤니티 ID '1234567890123456789'에서 최신 트윗을 가져옵니다. - 'AI 창업자' 목록을 검색해 보세요. 목록 ID, 이름, 설명, 회원 수를 포함한 상위 10개 목록을 반환합니다. - 목록 ID '987654321098765432'에서 구성원을 가져오고, 다음 커서를 포함하고, 결과를 전망 테이블 형식으로 지정합니다. ### X 쓰기 작업 - 'Twexapi 통합 v2.0이 방금 출시되었습니다.'라는 트윗을 게시하세요. 이제 MCP 설정은 2분도 채 걸리지 않습니다.` - 트윗 ID `1803006263529541838`에 다음과 같이 답장하세요. `이것은 유용한 예입니다. Twexapi MCP를 통해 테스트했습니다.` - 이미지 URL `https://example.com/launch.png` 및 텍스트: `새 출시: Twexapi MCP가 이제 에이전트 워크플로를 지원합니다.`로 트윗을 만듭니다. - 간결하고 기술적인 스타일로 `https://x.com/elonmusk/status/1803006263529541838`에 대한 답변 초안을 작성하되 보내지 마세요. :::warning 쓰기 작업은 `read_only: false`로 표시됩니다. 게시, 답글, 팔로우, 차단 또는 기타 부작용을 일으키는 작업을 수행하기 전에 명시적인 사용자 확인이 필요합니다. ::: ### 계정 및 사용량 - `/twitter/global-trending/tweets`에 대한 MCP 요청이 `401`을 반환한 이유를 설명하고 확인해야 할 헤더를 나열하세요. - 내 MCP 요청이 '403 사용 가능한 크레딧 없음!'을 반환한 이유와 재시도하기 전에 수행해야 할 작업을 설명하세요. - 대량 팔로어 추출에서 '429'가 반환된 이유를 설명하고 재시도 및 페이지 매김 계획을 제안합니다. - 이 작업이 MCP를 사용해야 하는지 직접 REST를 사용해야 하는지 결정합니다. '매일 아침 @openai에 대한 10,000명의 팔로어를 가져와 내 데이터베이스에 저장합니다.' ## 프레임워크 가이드 원하는 프레임워크에서 Twexapi MCP 도구를 사용하여 에이전트를 구축하세요. Twexapi MCP 도구를 LangChain 및 LangGraph 에이전트에 연결합니다. 하나의 Twexapi MCP 연결을 공유하는 연구진을 구축하세요. Streamable HTTP MCP 도구와 함께 유형이 안전한 에이전트를 사용하세요. Gemini 기반 ADK 에이전트에 Twexapi 도구를 추가합니다. TypeScript 에이전트를 원격 Twexapi MCP 도구에 연결합니다. 에이전트 출력을 n8n, Zapier, Make 및 Pipedream에 전달합니다. ## AI 에이전트 스킬 Twexapi 기술은 MCP 연결 없이도 AI 코딩 에이전트에 Twexapi API에 대한 심층적인 지식을 제공합니다. 에이전트가 API 통합을 작성하고, MCP 연결을 구성하고, Twexapi 모범 사례를 사용할 수 있도록 설치하세요. ```bash npx skills add twexapi-dev/x-api-scraper-cli ```