How do I add MakeAIVideo to Claude or ChatGPT?

Paste the server URL, https://app.makeaivideo.ai/api/mcp, as a custom connector. The client reads our OAuth discovery documents, registers itself, and walks you through sign-in, so you should not need to paste an API key.

Does the MCP server need an API key?

Not when you connect through OAuth, which is the normal path for Claude and ChatGPT. For a client you are writing yourself, send an Authorization: Bearer mav_... header instead.

What can an assistant do once it is connected?

The same things the API can, subject to the scopes you consent to: read your videos, create and edit them, and use the generation helpers. Consent is scoped to read, write and ai.

Why am I getting JSON-RPC error -32001?

The request reached the server without valid credentials. It is returned as a JSON-RPC error rather than an HTTP error, and it usually means the client dropped the Authorization header or the OAuth grant expired.

MCP server

MakeAIVideo speaks the Model Context Protocol, so an assistant can make videos directly rather than you wiring up HTTP calls. Same account, same credits, same scopes as an API key.

The endpoint

Server URL

https://app.makeaivideo.ai/api/mcp

It is a streamable HTTP MCP server. Authentication is required: either OAuth, which most clients handle for you, or an Authorization: Bearer mav_... header.

Claude and ChatGPT

Both accept a custom connector by URL. Add the server URL above; the client discovers the authorization server, registers itself, and walks you through sign-in. You should not need to paste a key.

Claude — Settings, Connectors, Add custom connector, paste the URL.
ChatGPT — Settings, Connectors, add by URL. Availability depends on your plan.

Discovery is served at /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server, with dynamic client registration and PKCE (S256). Consent is scoped to read, write and ai, the same three scopes described in Authentication.

Claude Code

Add it with a key:

shell

claude mcp add --transport http makeaivideo \
  https://app.makeaivideo.ai/api/mcp \
  --header "Authorization: Bearer $MAV_API_KEY"

Talking to it directly

For debugging, or a client you are writing yourself. List the tools the server exposes:

curl

curl -X POST https://app.makeaivideo.ai/api/mcp \
  -H "Authorization: Bearer $MAV_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

An unauthenticated request returns JSON-RPC error -32001 rather than an HTTP error, which is the usual sign a client dropped the auth header.

MCP server questions

How do I add MakeAIVideo to Claude or ChatGPT?: Paste the server URL, https://app.makeaivideo.ai/api/mcp, as a custom connector. The client reads our OAuth discovery documents, registers itself, and walks you through sign-in, so you should not need to paste an API key.
Does the MCP server need an API key?: Not when you connect through OAuth, which is the normal path for Claude and ChatGPT. For a client you are writing yourself, send an Authorization: Bearer mav_... header instead.
What can an assistant do once it is connected?: The same things the API can, subject to the scopes you consent to: read your videos, create and edit them, and use the generation helpers. Consent is scoped to read, write and ai.
Why am I getting JSON-RPC error -32001?: The request reached the server without valid credentials. It is returned as a JSON-RPC error rather than an HTTP error, and it usually means the client dropped the Authorization header or the OAuth grant expired.

Prefer plain HTTP? The REST quickstart covers the same workflow with curl.