SOPs - Setup Procedures Fresh

Step-by-step procedures for getting the X MCP servers running and connected to your AI tools.

flowchart LR
    A[Get Developer Access] --> B[Install XMCP]
    B --> C[Configure Credentials]
    C --> D[Connect an MCP Client]
    D --> E[Tool Allow-Listing]
    A --> F[Connect the Docs MCP]

Procedures

#	Procedure	What it covers
1	Get Developer Access	Developer account, app credentials, and your first API request
2	Install XMCP (local)	Clone the repo, create a venv, install dependencies, start the server
3	Configure Credentials	The .env file, OAuth keys, Bearer token, and callback registration
4	Connect an MCP Client	Wire Cursor, Windsurf, Claude, or a custom agent to XMCP
5	Connect the Docs MCP	Add the hosted documentation search server
6	Tool Allow-Listing	Restrict which X API operations an agent can call
7	Generate an OAuth 2.0 Token	Optional OAuth 2.0 user token and the Grok test client

Prerequisites at a glance

• Python 3.9+ for the XMCP server
• An X Developer Platform app (for consumer key, secret, and Bearer token)
• An MCP-compatible client - Cursor, Windsurf, Claude, or your own implementation
• Optional: an xAI API key to run the Grok test client

Do not commit secrets

Your .env holds live API credentials. Keep it out of version control and never paste consumer secrets or tokens into shared chats or screenshots.