Saltar al contenido principal

Connect Claude (web, Desktop and mobile)

Add Voxmin to Claude as a custom connector and sign in with your Voxmin account, so Claude can make pictures, songs and karaoke with your Voxmin credits.

Claude (web, Desktop and mobile)

Claude's custom connectors reach Voxmin's MCP server directly. You add Voxmin once in your Claude account, sign in with your Voxmin account, and it works in Claude on the web, in Claude Desktop and in the mobile apps.

Before you start

  • A Voxmin account with some credits.
  • A Claude plan with custom connectors: Free (one custom connector), Pro, Max, Team or Enterprise. On Team and Enterprise, an owner adds connectors for the organization (see below).

Add Voxmin

Open Connectors

In Claude, open Settings → Connectors and choose Add custom connector.

Name it and paste the URL

Name it Voxmin and paste the MCP server URL:

https://api.voxmin.com/auth/mcp

Keep Authentication on Sign in now, and the OAuth client on Use Claude's published identity. Voxmin supports it, so there is nothing else to fill in. Leave Request headers empty.

Add, then connect

Choose Add, then Connect. Claude opens Voxmin in your browser: log in if you are asked, check that the page names Claude, and choose Approve. You are taken back to Claude.

Team and Enterprise: an owner adds Voxmin under Organization settings → Connectors → Add → Custom → Web, with the same URL. Each member then opens Settings → Connectors, finds Voxmin and chooses Connect, signing in with their own Voxmin account, so each member spends their own credits.

Check it works

  1. In a new chat, open the tools menu and turn Voxmin on.
  2. Ask: "What's my Voxmin balance?" Claude calls get_account and answers with your credits.
  3. Claude asks before it uses each tool. Read the price in the request before you allow a spending tool.

Voxmin lists Claude under AI Integrations → Connected apps. Sign out there stops it at once.

With a personal token instead

If your Claude Desktop cannot add custom connectors, add Voxmin through its config file. That file starts local servers, so Voxmin is reached through mcp-remote, a small bridge that needs Node.js 18 or newer.

Make a token

On AI Integrations, make a token. It starts with vxm_ and is shown only once, so copy it then.

Open the config file

In Claude Desktop, open Settings → Developer → Edit Config. That opens claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the Voxmin server

Add a voxmin entry under mcpServers (keep any servers already there), with your token in place of <your token>:

claude_desktop_config.json
{
    "mcpServers": {
        "voxmin": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://api.voxmin.com/auth/mcp",
                "--header",
                "Authorization:${VOXMIN_AUTH}"
            ],
            "env": {
                "VOXMIN_AUTH": "Bearer <your token>"
            }
        }
    }
}

The header is written as Authorization:${VOXMIN_AUTH} with no space on purpose: on Windows, Claude Desktop does not escape spaces inside args. The space between Bearer and the token lives in env, where it is safe.

Restart Claude Desktop

Quit Claude Desktop completely and open it again. The config file is only read at start-up.

Troubleshooting

What you seeWhyWhat to do
"Couldn't reach the MCP server" when addingThe URL has a typo, or a space at either endPaste the URL again exactly as shown above
The Voxmin page says the sign-in has endedIt waited more than 10 minutes, or was already answeredChoose Connect again in Claude
Voxmin is connected but not in the tools menuIt is switched off for this chatTurn it on in the chat's tools menu
"Custom header names need Anthropic approval"A request header was addedRemove the connector, add it again with no request headers, and sign in instead
Voxmin stopped workingIt was signed out on Voxmin, or not used for 90 daysChoose Connect again in Claude's Connectors
"Daily credit cap reached" (token setup)Today's spend through this token would pass its capWait until midnight UTC, or make a token with a higher cap
"Not enough credits"Your balance is lower than the tool's priceTop up on the Pricing page
429 Too Many RequestsMore than 60 requests in a minuteWait a minute and try again
The request is refusedIt did not pass Voxmin's content checksChange the request. A refused picture is not charged

See the overview for every tool, its price and how billing works.

Lo que dicen los desarrolladores

De desarrolladores que integran la API de Voxmin en sus aplicaciones.

“Centralizar el procesamiento de audio redujo la lógica especial que manteníamos en cada cliente.”
Á

Álvaro P.

Líder técnico, Valencia

“La documentación nos ayudó a validar los payloads antes de conectar nuestro procesador por lotes.”
M

Mateo C.

Ingeniero de plataforma, Bogotá

“Usamos los estados de trabajo para mostrar un progreso claro sin bloquear nuestra aplicación.”
S

Sofía R.

Desarrolladora full-stack, Buenos Aires

“La API asíncrona encaja bien con nuestra cola de trabajos y mantiene la integración sencilla.”
I

Irene V.

Desarrolladora backend, Madrid