본문으로 건너뛰기
Twexapi
한국어
English简体中文日本語Español한국어FrançaisTürkçe
Esc
↑↓이동↵열기⌘J미리보기
이 페이지에서

MCP 서버

Model Context Protocol을 통해 AI 에이전트를 Twexapi에 연결합니다.

MCP를 통해 AI 에이전트 연결

Twexapi는 AI 에이전트 및 개발 도구가 프로그래밍 방식으로 Twexapi 계정과 상호 작용할 수 있게 해주는 모델 컨텍스트 프로토콜 서버를 실행합니다.

이 페이지에서는 인증된 API 작업을 위한 https://api.twexapi.io/mcp의 API MCP 서버를 다룹니다. 읽기 전용 문서 검색의 경우 https://docs.twexapi.io/mcp에서 Docs MCP 서버를 사용하세요.

연결

규약

MCP 클라이언트를 위한 스트리밍 가능한 HTTP 전송이 포함된 HTTP입니다.

엔드포인트

클라이언트를 다음 URL에 연결합니다.

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 서버 검색 메타데이터는 다음 위치에서 확인할 수 있습니다.

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’와 동일한 키를 보낼 수 있습니다.

입증

MCP 서버는 다음과 같은 인증 방법을 지원합니다.

  • API 키(x-api-key 헤더): 원격 브리지를 통해 Claude Code, Cursor, VS Code, Windsurf, Codex CLI, OpenCode 및 Claude Desktop에서 사용됩니다. MCP 핸드셰이크 중에 키를 전달합니다.
  • Bearer 토큰(Authorization: Bearer <token>): Authorization 헤더를 선호하는 클라이언트가 사용합니다. 이는 Twexapi API 키일 수도 있고 OAuth가 활성화된 경우 OAuth 토큰일 수도 있습니다.

Twexapi 대시보드에서 API 키를 생성하세요.

작동 원리

MCP 서버는 두 가지 도구를 노출합니다.

explore

Twexapi API 카탈로그를 검색하세요. 이는 검색 도구입니다. 엔드포인트 이름, 메서드, 경로, 범주, 매개 변수 스키마, 예제 및 안전 플래그를 반환합니다.

twexapi_request

인증된 Twexapi API 호출을 실행합니다. 비용은 기본 엔드포인트를 따릅니다.

에이전트는 먼저 explore로 검색한 다음 반환된 메서드와 상대 경로를 사용하여 twexapi_request를 호출합니다. 인증은 MCP 요청에서 자동으로 주입됩니다.

‘탐색’ 도구

인메모리 API 엔드포인트 카탈로그를 검색합니다. 호출에는 여전히 API 키 또는 Bearer 토큰을 통한 MCP 인증이 필요합니다.

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<string, unknown>;
  example?: Record<string, unknown>;
}

twexapi_request 도구

허용 목록에 있는 Twexapi REST 엔드포인트에 대해 API 호출을 실행합니다.

declare const twexapi_request: {
  method: string;
  path: string;
  query?: Record<string, unknown>;
  body?: unknown;
};

호출 예시:

{
  "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 <token>을 사용하여 https://api.twexapi.io/*를 호출합니다. 엔드포인트, 페이지 매김, 응답 처리 또는 직접 SDK 코드에 대한 세부적인 제어가 필요한 경우 API 참조를 사용하세요.

에이전트가 자연어를 통해 X/Twitter 데이터와 상호 작용하도록 하려면 MCP를 사용하십시오. 프로덕션 백엔드, 예약된 작업 또는 직접 통합을 구축하는 경우 REST를 사용하세요.

설정

웹 및 터미널 클라이언트

클로드.ai

Claude.ai는 작업 공간에 대해 MCP 커넥터가 활성화되면 원격 MCP 서버에 연결할 수 있습니다. 서버 URL로 https://api.twexapi.io/mcp를 사용합니다. OAuth 지원 작업공간은 브라우저에서 인증을 완료할 수 있습니다. API 키 클라이언트는 x-api-key를 사용해야 합니다.

클로드 데스크탑

Claude Desktop은 stdio 전송만 지원합니다. ‘mcp-remote’ npm 패키지를 브리지로 사용합니다.

{
  "mcpServers": {
    "twexapi": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.twexapi.io/mcp",
        "--header",
        "x-api-key:twexapi_YOUR_KEY_HERE"
      ]
    }
  }
}

클로드 코드

.mcp.json에 추가합니다.

{
  "mcpServers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

코덱스 CLI

~/.codex/config.toml에 추가:

[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
http_headers = { "x-api-key" = "twexapi_YOUR_KEY_HERE" }

편집자 클라이언트

커서

~/.cursor/mcp.json(전역) 또는 .cursor/mcp.json(프로젝트)에 추가합니다.

{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

VS 코드

.vscode/mcp.json(프로젝트)에 추가하거나 MCP: 사용자 구성 열기(전역)를 사용합니다.

{
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

윈드서핑

~/.codeium/windsurf/mcp_config.json에 추가:

{
  "mcpServers": {
    "twexapi": {
      "serverUrl": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

오픈코드

opencode.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를 사용합니다.

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에 대한 답변 초안을 작성하되 보내지 마세요.

계정 및 사용량

  • /twitter/global-trending/tweets에 대한 MCP 요청이 401을 반환한 이유를 설명하고 확인해야 할 헤더를 나열하세요.
  • 내 MCP 요청이 ’403 사용 가능한 크레딧 없음!’을 반환한 이유와 재시도하기 전에 수행해야 할 작업을 설명하세요.
  • 대량 팔로어 추출에서 ’429’가 반환된 이유를 설명하고 재시도 및 페이지 매김 계획을 제안합니다.
  • 이 작업이 MCP를 사용해야 하는지 직접 REST를 사용해야 하는지 결정합니다. ‘매일 아침 @openai에 대한 10,000명의 팔로어를 가져와 내 데이터베이스에 저장합니다.’

프레임워크 가이드

원하는 프레임워크에서 Twexapi MCP 도구를 사용하여 에이전트를 구축하세요.

LangChain

Twexapi MCP 도구를 LangChain 및 LangGraph 에이전트에 연결합니다.

CrewAI

하나의 Twexapi MCP 연결을 공유하는 연구진을 구축하세요.

Pydantic AI

Streamable HTTP MCP 도구와 함께 유형이 안전한 에이전트를 사용하세요.

Google ADK

Gemini 기반 ADK 에이전트에 Twexapi 도구를 추가합니다.

Mastra

TypeScript 에이전트를 원격 Twexapi MCP 도구에 연결합니다.

노코드 워크플로

에이전트 출력을 n8n, Zapier, Make 및 Pipedream에 전달합니다.

AI 에이전트 스킬

Twexapi 기술은 MCP 연결 없이도 AI 코딩 에이전트에 Twexapi API에 대한 심층적인 지식을 제공합니다. 에이전트가 API 통합을 작성하고, MCP 연결을 구성하고, Twexapi 모범 사례를 사용할 수 있도록 설치하세요.

npx skills add twexapi-dev/x-api-scraper-cli

이 페이지가 도움이 되었나요?