Troubleshooting

​

Build failures

​

Missing config.yaml

Error: config.yaml not found

name: "your-server"
tools: []

​

Missing tool declaration

Tool 'my_tool' not found in config.yaml

tools:
  - name: "my_tool"
    description: "What it does"

​

Dependency errors

Error: Could not find package 'some-package'

uv add some-package
git add pyproject.toml uv.lock
git commit -m "Add dependency"
git push

​

Build timeout

1. Check for large dependencies
2. Ensure you’re not downloading large files at build time
3. Contact support if the issue persists

​

Runtime errors

​

Tool blocked

Permission denied: Tool 'delete_all' is restricted for your permission group

​

Credentials not found

No credentials found for provider 'linear'

​

Invalid token

401 Unauthorized: Invalid or expired token

• User’s session expired
• Token was revoked
• Misconfigured MCP client

​

Viewing logs

​

Build logs

​

Runtime logs

​

Still stuck?

• Server ID
• Deployment ID (if build issue)
• Error message
• Steps to reproduce