TweetAPI

エージェントと MCP

AI コーディングエージェントで TweetAPI を使う方法は 2 つあります。最新ドキュメントと読み取り専用 API アクセスにはホスティング MCP を使い、エージェントがアプリケーションに TweetAPI を組み込む場合は通常の SDK またはサーバー側コードを使います。

公開製品の概要、要件、接続フローは TweetAPI Twitter API MCP サーバーページをご覧ください。

ホスティング MCP

エージェントクライアントを次の URL に接続します。

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 サーバーを追加し、2 つ目は 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 サーバーを追加し、2 つ目は 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" の公開プロフィールを取得してください。
ライブツール呼び出しは正確に 1 回だけ行い、使用したツールを示してください。

ライブツール呼び出しは通常の 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")