Medux
Setup guide · Claude Code

Use Medux MCP in Claude Code

Connect the hosted Medux MCP server to Claude Code and call its media tools from your prompts.

CodexClaude Code

Before you start

A Medux account

Tools use the shared Medux credits system. See pricing.

Claude Code

Claude Code installed and signed in (npm i -g @anthropic-ai/claude-code, or the native installer).

Step-by-step setup

01

Get your API key

Sign in at medux.io/account/api-keys and create a key. It looks like sk-medux-.... Copy it once and store it safely.

Keep it secret: never commit the key to git. Prefer an environment variable, as shown below.
02

Add Medux MCP to Claude Code

The remote MCP endpoint is the same for every tool: https://mcp.medux.ai. Medux hosts it, so there is nothing to install or run locally.

Add the server with one command:

claude mcp add --transport http medux https://mcp.medux.ai --header "Authorization: Bearer sk-medux-..."

By default this is saved for you in the current project (local scope). Choose a scope with --scope:

ScopeWhere it applies
local (default)Only you, only this project.
userYou, in every project: --scope user
projectShared with the team via .mcp.json: --scope project

To keep the key out of a shared file, reference an environment variable in .mcp.json:

{
  "mcpServers": {
    "medux": {
      "type": "http",
      "url": "https://mcp.medux.ai",
      "headers": {
        "Authorization": "Bearer ${MEDUX_API_KEY}"
      }
    }
  }
}
export MEDUX_API_KEY="sk-medux-..."

The hosted server also supports OAuth. If you omit the header, run /mcp inside Claude Code, select medux and choose Authenticate to sign in through your browser.

03

Verify the connection

List configured servers from your terminal:

claude mcp list

Then start claude in the folder with your videos and type /mcp. medux should be shown as connected.

You should see tools prefixed with medux_, for example:

ToolPurpose
medux_text_to_imageGenerate an image from a text prompt.
medux_video_generate_text_to_videoGenerate a video from a text prompt.
medux_speech_create_audioConvert text to speech.
medux_file_create_upload_urlGet a signed upload URL and file_id so local files can be used as input.
medux_task_queryCheck an async task by task_id and get the result URL.

Browse every tool in the MCP overview.

04

Use it from a prompt

Just ask in natural language and mention Medux so the agent picks the right tools:

Use Medux to generate a 1024x1024 image of a red fox in watercolor style.
Use Medux to turn this text into speech: "Welcome to Medux." Give me the audio link.
Use Medux to remove the background from photo.png in this folder.

Under the hood the agent chooses a medux_* tool and fills in its parameters. For a local file it first calls medux_file_create_upload_url, uploads the file with an HTTP PUT to the returned upload_url using the returned content_type, and passes the file_id to the tool. Most tools run as async tasks, so the agent polls medux_task_query until the task completes and then shows you the result URL.

Troubleshooting

SymptomFix
401 UnauthorizedThe key is missing or wrong. Re-copy it, confirm the Bearer prefix, and make sure any environment variable is set in the shell that launched Claude Code.
No medux_* tools listedRun /mcp in Claude Code to see the error. Restart the session after changing config, and confirm the server scope with claude mcp get medux. For a project-scoped server, approve it when Claude Code prompts.
Local-file upload failsUpload URLs expire. Request a fresh one and send the exact content_type returned.
Insufficient creditsTop up or upgrade on the pricing page.

Next

Using the other client? Read the Codex setup guide, or browse all tutorials.