Troubleshooting

Resolve Pixloop MCP connection, authorization, tool discovery, job, and credit issues.

Common issues

Connector cannot reach the server

Use the public HTTPS endpoint, not localhost or a private network URL. If a client asks for a path, use /mcp.

Authorization fails

Retry the connect flow, confirm the Pixloop account can access the workspace, and verify the client supports OAuth with PKCE.

No tools appear

Ask the client to reconnect and call tools/list again. The tool catalog is only returned after authentication.

A generation is still running

Use the returned next step, job ID, or workflow run ID with models(action="wait_job") or workflow(action="get_run").

Credits or publishing permissions are missing

Call account(action="balance") and publish(action="connections") to inspect account state before retrying.