📖 Setup Guide

Complete step-by-step instructions to get started with ConnectC2X

💡 What is ConnectC2X?

ConnectC2X is an MCP server that lets Claude (Desktop / claude.ai / iPhone) fetch and search tweets on X (Twitter). It supports tweet URL lookup, timeline fetching, keyword search, and automatically expands quote chains up to 5 levels deep.

⚠️ BYOK model: You need your own X API Bearer Token (obtainable from X Developer Portal)

🔑 Step 1: Get X API Bearer Token

1-1. Go to X Developer Portal

https://developer.x.com/en/portal/dashboard

※ Login with your X account is required

1-2. Create a developer account

Click "Sign up" → Enter use case (e.g., "Personal project to read tweets via MCP") → Agree to terms → "Submit" → Register payment method (pay-per-use)

1-3. Create a project and app

From the dashboard, click "+ Add App" → Enter project name (e.g., "MyMCP") → Enter app name (e.g., "connect-c2x") → Create

1-4. Copy the Bearer Token

After creating the app, copy the "Bearer Token" shown. It's a long string starting with "AAAAAAA...". If you missed it: Go to app's "Keys and Tokens" tab → Click "Regenerate" under "Bearer Token".

💰 X API is fully pay-per-use (~$0.005 per read). We strongly recommend setting a monthly spending cap in the Developer Portal.

📝 Step 2: Register on ConnectC2X

2-1. Sign in with Google

Click "Get Started" or "Sign in with Google" on the landing page and log in with your Google account.

2-2. Register Bearer Token on Dashboard

After login, paste the Bearer Token from Step 1 into the "X Bearer Token" field on the dashboard and click "Save". Your token is encrypted and stored securely.

🔗 Step 3: Connect from Claude

MCP Server URL:

https://kitepon.dev/mcp

🖥️ Claude Desktop / 🌐 claude.ai

Settings → "Connectors" → "Add Custom Connector" → Name: X-API, URL: https://kitepon.dev/mcp → "Add" → "Connect" → Sign in with Google → Connected

💻 Claude Code (VSCode / CLI)

Add to mcpServers in ~/.claude.json:

"x-api": {
  "type": "http",
  "url": "https://kitepon.dev/mcp"
}

→ Restart Claude Code → OAuth auth URL shown → Open in browser → Google login → Connected

📱 iPhone / Mobile

Once you set up the connector on claude.ai, it automatically syncs to the Claude mobile app. No additional setup needed.

🚀 Step 4: Start Using

After connecting, try asking Claude:

💬 Fetch a tweet:

What does this tweet say? https://x.com/AnthropicAI/status/...

💬 Fetch timeline:

Show me the latest tweets from @AnthropicAI

💬 Search:

Search for tweets about "Claude Code" in English

💡 Claude automatically uses the fetch_tweet tool when you paste a tweet URL. Quote tweets are expanded up to 5 levels deep.

🤖 Using with other AI clients

ConnectC2X is tested with Claude, but it should work with any MCP-compatible AI client (Cursor, Windsurf, GitHub Copilot, OpenAI Codex, etc.). However, we do not guarantee compatibility — please try with the Free tier first.

🛠️ Available Tools

Tool	Description
fetch_tweet	Fetch a tweet by ID or URL. Expands quote chains up to 5 levels.
fetch_timeline	Fetch a user's latest tweets.
search_tweets	Search tweets from the past 7 days by keyword.

❓ Troubleshooting

OAuth login screen doesn't appear

Restart Claude Desktop / Code. Check that the MCP URL is correct (no trailing slash).

"X Bearer Token not registered" error

"Invalid token" error when saving token

Verify your Bearer Token from X Developer Portal is correct. URL-encoded characters like %2F or %3D can be pasted as-is.

Free tier limit reached

Free plan is limited to 3 calls per day. It resets the next day. Upgrade to Pro (¥300/month) for unlimited access.