TweetAPI

에이전트 및 MCP

AI 코딩 에이전트에서 TweetAPI를 사용하는 방법은 두 가지입니다. 최신 문서와 읽기 전용 API 접근에는 호스팅 MCP를 사용하고, 에이전트가 애플리케이션에 TweetAPI를 통합할 때는 일반 SDK 또는 서버 측 코드를 사용합니다.

공개 제품 개요, 요구 사항, 연결 흐름은 TweetAPI Twitter API MCP 서버 페이지를 참고하세요.

호스팅 MCP

에이전트 클라이언트를 다음 주소에 연결하세요.

https://mcp.tweetapi.com/mcp

호스팅 MCP는 대시보드 권한 승인을 사용합니다. MCP 서버를 추가하는 작업은 에이전트 클라이언트에 서버 설정만 저장합니다. 클라이언트의 MCP 로그인/권한 승인 명령을 실행하여 브라우저에서 TweetAPI를 열고, 연결에 사용할 API 키를 선택한 뒤 tweetapi:read를 승인하세요. 클라이언트가 MCP 토큰을 저장하므로 앱이나 컴퓨터를 재시작해도 연결이 유지됩니다.

실시간 MCP 도구는 읽기 전용이며 공개 고객용 엔드포인트로 제한됩니다. 실시간 도구 호출은 기존 TweetAPI API로 전달되고 일반 API 할당량을 사용합니다.

빠른 설치

Codex에서는 다음을 실행하세요.

codex mcp add tweetapi --url https://mcp.tweetapi.com/mcp
codex mcp login tweetapi

Claude Code에서는 다음을 실행하세요.

claude mcp add --transport http --scope user tweetapi https://mcp.tweetapi.com/mcp
claude mcp login tweetapi

Cursor에서는 ~/.cursor/mcp.json에 다음을 추가하세요.

{
  "mcpServers": {
    "tweetapi": {
      "url": "https://mcp.tweetapi.com/mcp"
    }
  }
}

Codex와 Claude Code 명령은 한 번에 하나씩 실행하세요. 추가/설치 명령만으로는 브라우저가 열리지 않습니다. 로그인/권한 승인 명령을 실행하면 TweetAPI가 열리고 로그인한 다음 연결에 사용할 API 키를 선택해 접근을 승인할 수 있습니다. Cursor는 저장된 원격 서버에 처음 연결할 때 OAuth를 시작합니다.

할 수 있는 작업

  • 최신 TweetAPI 문서를 검색합니다.
  • 코드를 작성하기 전에 엔드포인트 매개변수를 확인합니다.
  • 에이전트 채팅에서 실시간 읽기 전용 X/Twitter 조회를 실행합니다.
  • 기존 TweetAPI 할당량과 청구 방식을 그대로 사용합니다.

요구 사항

  • TweetAPI 계정
  • 대시보드 승인 흐름에서 선택한 TweetAPI API 키
  • 원격 HTTP MCP를 지원하는 Codex, Claude Code 또는 다른 에이전트 클라이언트

Codex에 설치

다음을 실행하세요.

codex mcp add tweetapi --url https://mcp.tweetapi.com/mcp
codex mcp login tweetapi

명령을 한 번에 하나씩 실행하세요. 첫 번째 명령은 MCP 서버를 추가합니다. 두 번째 명령은 MCP 접근을 승인할 TweetAPI 화면을 엽니다. 기존 API 키를 선택하거나 대시보드에서 MCP 전용 키를 만드세요. 추가와 로그인 후 Codex를 재시작하거나 새 채팅을 여세요. Codex에서 /mcp를 실행하거나 모델에 TweetAPI MCP 도구 목록을 요청할 수 있습니다.

대시보드 연결을 취소하거나 연결된 API 키를 삭제한 경우 다시 연결하기 전에 오래된 로컬 클라이언트 세션을 지우세요.

codex mcp logout tweetapi
codex mcp login tweetapi

그런 다음 Codex를 완전히 재시작하고 새 채팅을 시작하세요.

Claude Code에 설치

다음을 실행하세요.

claude mcp add --transport http --scope user tweetapi https://mcp.tweetapi.com/mcp
claude mcp login tweetapi

명령을 한 번에 하나씩 실행하세요. 첫 번째 명령은 MCP 서버를 추가합니다. 두 번째 명령은 TweetAPI 대시보드 승인 화면을 엽니다. 토큰이나 API 키가 들어 있는 에이전트 설정 파일을 소스 제어에 커밋하지 마세요.

대시보드 연결을 취소했다면 Claude Code에 저장된 TweetAPI MCP 인증/세션을 제거하고 claude mcp login tweetapi를 다시 실행하세요.

Cursor에 설치

전역 Cursor MCP 설정인 ~/.cursor/mcp.json에 TweetAPI를 추가하세요.

{
  "mcpServers": {
    "tweetapi": {
      "url": "https://mcp.tweetapi.com/mcp"
    }
  }
}

Cursor가 새 서버를 즉시 감지하지 못하면 재시작하세요. Cursor가 연결되면 브라우저에서 TweetAPI OAuth 승인을 완료하고 연결에 사용할 API 키를 선택하세요.

연결 테스트

MCP를 설치한 뒤 새 채팅을 시작하고 다음과 같이 요청하세요.

사용할 수 있는 TweetAPI MCP 도구 목록을 보여 주세요. 그런 다음 TweetAPI 문서에서 검색
엔드포인트를 찾아 필수 매개변수를 설명하세요. 아직 실시간 TweetAPI 도구는 호출하지 마세요.

실시간 읽기 전용 접근을 테스트하려면 다음과 같이 요청하세요.

TweetAPI MCP를 사용해 사용자 이름 "elonmusk"의 공개 프로필을 가져오세요. 실시간 도구 호출은
정확히 한 번만 하고 어떤 도구를 사용했는지 알려 주세요.

실시간 도구 호출은 일반 TweetAPI 요청 할당량을 사용합니다.

MCP를 사용할 때

채팅 중 모델이 최신 TweetAPI 문서를 확인하거나 엔드포인트 매개변수를 조회하거나 범위가 제한된 읽기 전용 TweetAPI 호출을 해야 할 때 호스팅 MCP를 사용하세요.

모델이 애플리케이션을 수정하는 경우에는 일반 SDK 또는 REST 통합 코드를 사용하세요. TweetAPI 호출은 서버 측에서 실행하고 서버 환경에서 API 키를 읽어야 합니다.

안전한 에이전트 프롬프트

TweetAPI를 사용해 이 기능을 내 앱에 추가하세요. 서버의 TWEETAPI_API_KEY에서 TweetAPI 키를
읽으세요. API 키, Twitter/X authToken, ct0, 프록시 자격 증명 또는 DM 내용을 소스 코드에
넣지 마세요. 엔드포인트 매개변수를 선택하기 전에 호스팅 TweetAPI MCP 문서 도구를 사용하세요.

Node.js 예제

npm install tweetapi-node

import TweetAPI from "tweetapi-node";

const client = new TweetAPI({ apiKey: process.env.TWEETAPI_API_KEY! });
const result = await client.explore.search({
  query: "tweetapi",
  type: "Latest",
});

Python 예제

pip install tweetapi

import os
from tweetapi import TweetAPI

client = TweetAPI(api_key=os.environ["TWEETAPI_API_KEY"])
result = client.search.search(query="tweetapi", type="Latest")