Connect Claude Code

Use a workspace API key to make Ghostmotion’s tools available in Claude Code.

1. Create and save your key

Create an API key with read and write permissions. In your terminal, replace the placeholder below with the key. For production automation, use your environment’s secret manager.

export GHOSTMOTION_API_KEY='YOUR_API_KEY'

2. Add the server

claude mcp add --transport http ghostmotion \
  https://app.ghostmotion.ai/mcp \
  --header 'Authorization: Bearer ${GHOSTMOTION_API_KEY}'

The single quotes preserve the environment-variable reference in the configuration. Claude Code reads its value when it connects. Start Claude Code from the same terminal environment. If it was already running, restart it after adding the server.

3. Check the tools

claude mcp list

Open Claude Code and ask it to list your Ghostmotion projects. If authentication fails, check that GHOSTMOTION_API_KEY is available to the running client and that the key is active. Do not paste a key into chat.

4. Make and edit a video

Ask for a video using Ghostmotion. After the tool returns a run ID, ask the assistant to check progress and return the result. Read the MCP workflow guide and tool reference for the full flow.

Client configuration reference: official Claude Code documentation .