Connect Superdirector to AI apps

Use your Superdirector account from ChatGPT, Claude, Codex, or Claude Code. Free accounts can connect and read account status; metered work tools use credits, and the $29 plan includes recurring credits plus the full self-serve workflow.

Current status

Account connections and all tools are live.

Connect an AI app to your Superdirector account and list the full 15-tool set. Seven read/status tools are free; four workflow actions require self-serve workflow access with no extra credits; four metered work tools use credits: brand profile analysis, video analysis, reference search, and content briefs.

Setup URL

Use this URL in connector settings and local MCP client configs. If this environment is not configured yet, keep the placeholder and set the endpoint in Vercel before testing.

https://superdirector.app/mcp

Client setup

Each app connects the same way: point it at the setup URL, sign in with your Superdirector account, and approve the connection. You can review or disconnect any app later from Settings → Billing in Superdirector.

ChatGPT

Add Superdirector as a connector. Until Superdirector is listed in the connector directory, create it yourself in developer mode.

Open ChatGPT Settings and go to Connectors.
Enable Developer Mode (Settings → Connectors → Advanced), then choose Create.
Enter the setup URL below and pick OAuth as the authentication method.
Complete the Superdirector sign-in and approval screen.
In a chat, enable the connector under the plus menu, then ask for your Superdirector account status to confirm it works.

ChatGPT waits on each tool call, so Superdirector returns long work (searches, briefs) as a task right away. If ChatGPT shows a task id and stops, ask it to "check the task" — it will poll get_task_status for you.

Claude (web and desktop)

Add Superdirector as a custom connector. On Team or Enterprise plans, a workspace owner may need to approve it first.

Open Claude settings and go to Connectors.
Choose Add custom connector.
Enter the setup URL below.
Complete the Superdirector sign-in and approval screen.
In a chat, check that Superdirector tools appear in the search-and-tools menu.

Claude follows the tool descriptions and polls tasks on its own. If a long search appears stalled, ask Claude to check the task status.

Codex CLI

Add the server to ~/.codex/config.toml, then sign in once from the terminal.

Add the server entry below to your Codex config.
Run `codex mcp login superdirector` and complete the browser sign-in.
Start Codex and run a read-only prompt first, for example "What is my Superdirector account status?".

[mcp_servers.superdirector]
url = "https://superdirector.app/mcp"
# Optional: Codex defaults to 60s per tool call. Superdirector returns
# long work as tasks, so the default is fine. Raise it only if you want
# inline video analysis to wait longer before handing back a task.
# tool_timeout_sec = 120

Codex enforces a per-tool-call timeout (60s by default). Every Superdirector tool answers well inside that — long work comes back as a task to poll — so no timeout change is required.

Claude Code

Add the server from the terminal, then authenticate inside Claude Code.

Run the add command below (add --scope project to share it via .mcp.json).
Open Claude Code and run /mcp.
Select superdirector and complete the browser sign-in.
Ask for your Superdirector account status to confirm the connection.

claude mcp add --transport http superdirector "https://superdirector.app/mcp"

Claude Code applies MCP_TOOL_TIMEOUT to tool calls. Superdirector stays within default limits because long work returns a task id instead of blocking the call.

How long-running work behaves

Reference searches usually take 30–90 seconds and content briefs take several minutes — longer than most AI apps will wait on a single tool call. Instead of blocking, Superdirector returns a task:

search_reference_videos and generate_content_briefalways return a task id immediately. The work continues on Superdirector's servers.
analyze_public_video answers inline when the analysis finishes quickly (for example, the video was analyzed before) and returns a task otherwise.
The AI app polls get_task_status and fetches the output with get_task_result. The tool descriptions tell it how often to check, so this normally happens without any prompting.
Task results are kept for 24 hours. Credits are only spent on the underlying work — checking a task is always free.

Tools

The connected app sees these 15 tools. Included read tools never spend credits; workflow actions require self-serve access but no extra credits; metered work tools use the same credits as the web app and tell the AI app their cost up front.

Tool	What it does	Billing
Account status	Read the signed-in account plan, credit balance, and tracked-profile allowance.	Included
Tracked profiles	Read the profiles the user already tracks in Superdirector.	Included
Analyze a brand profile	Run Brand DNA analysis for a public Instagram or TikTok account.	Uses credits
Read brand DNA	Read tone, pillars, visual style, and engagement patterns for an analyzed profile.	Included
List similar accounts	Read saved competitor and similar-account research for a brand profile.	Included
Discover similar accounts	Find and save new competitor accounts for a brand profile when workflow access is enabled.	Workflow access
Scan content ideas	Generate fresh content ideas grounded in a tracked profile when workflow access is enabled.	Workflow access
List content ideas	Read saved content ideas for a brand profile.	Included
Regenerate a plan stage	Restart a production plan from research, brief, screenplay, storyboard, or shot list when workflow access is enabled.	Workflow access
Rewrite a script	Rewrite a generated script and refresh downstream plan stages from instructions when workflow access is enabled.	Workflow access
Analyze a public video	Run the same paid public-video analysis pipeline used in the web app.	Uses credits
Search reference videos	Find public reference videos for a topic, account, or creative direction.	Uses credits
Generate a content brief	Create a concise script, storyboard, or production brief from approved context.	Uses credits
Check a task	Check whether a long-running analysis, search, or brief has finished.	Included
Fetch a task result	Fetch the output of a completed long-running task.	Included

Billing and usage

You sign in with your Superdirector account — there are no Superdirector API keys to paste or rotate.
Free accounts can connect AI apps and use read/status tools. The $29 plan adds recurring credits and full self-serve workflow access.
Metered tools debit the same credit balance as the web app, at the same rates, with the same refund-on-failure behavior: a job that fails before producing usable output is not charged.
Usage from AI apps appears in Settings → Billing under Connected apps, split from your web app usage in the usage chart.
If your balance is too low for a tool, the AI app receives a clear message with your balance, the cost, and a link to manage your plan — nothing is charged.
Each connected app is listed in the billing panel with when you approved it and when it was last used. Disconnect revokes its access immediately.

Verify your connection

Server smoke test

Use MCP Inspector against the HTTPS endpoint. Confirm connection, metadata, tool listing, and error responses before trying an AI client.

npx @modelcontextprotocol/inspector
# Connect to https://superdirector.app/mcp

Read tools first

Ask the connected app for your account status and tracked profiles. Both are free and prove auth, scopes, and the tool list without spending credits.

One metered round trip

Run one reference search and let the app poll the task to completion. Then open Settings → Billing in Superdirector and confirm the usage appears under Connected apps.

Disconnect check

Disconnect the app from the billing panel and confirm the next tool call from that app is asked to sign in again.

Troubleshooting

The setup URL does not connect

Confirm the endpoint is public HTTPS and reachable from the AI app. If you are testing a preview deployment, deployment protection can block the connection — use the production endpoint or a bypass.

The AI app shows no tools

Disconnect and reconnect the app so it refreshes the tool list, then ask it to check your Superdirector account status. Connections approved before the tools went live need this one-time refresh.

A search or brief seems stuck

Ask the AI app to check the task status. Searches finish within a few minutes; briefs report their current stage while they run. If a task reports task_expired, the result aged out of the 24-hour window — run the tool again.

A tool says there are not enough credits

The message includes your balance and the cost. Top up or upgrade from the billing page it links to, then re-run the prompt — nothing was charged for the refused call.

Usage does not appear as connected-app usage

Only work started from a connected AI app is classified under Connected apps. Rows from before you connected the app, and anything run in the web app itself, stay under web usage.