Troubleshooting imports
When OpenAPI import or first calls go wrong, work top-down.
Import produces no tools
- Confirm the body is OpenAPI 3 JSON, not YAML and not a random JSON blob
- Check that
pathsexist and operations aren’t empty - Very large specs can hit tool caps — trim to the ops agents need
- Re-paste after fixing
operationIds / schemas
Import errors or rejects the URL
- Base URL must be a public
https://(or allowed) host - Localhost, RFC1918, and metadata IPs are blocked by design
- DNS must resolve from the server
Tools show up but calls fail
| Symptom | Likely cause |
| --- | --- |
| 401 from MakeCallable | Missing or wrong MCP Bearer apiKey |
| 401/403 from upstream | Wrong upstream secret or security scheme |
| 404 upstream | Base URL path mismatch vs OpenAPI servers |
| Timeout / 5xx | Upstream down or too slow |
Fix upstream with curl using the same base URL + secret, then retry via the agent.
Client doesn’t list tools
- Re-copy install config; confirm Bearer token is present
- Restart Cursor / Claude after config changes
- Confirm you’re on Streamable HTTP remote MCP, not a stale stdio snippet
Rate limited
Seat and call caps protect the host and your upstream. Slow down retries; raise caps later when activation quality holds.
Still stuck
Email hello@makecallable.com with: project slug, OpenAPI snippet (redact secrets), base URL host (not the key), and the client you’re installing.
Related: OpenAPI import · Upstream auth