Troubleshooting
Most problems come from the app configuration, an unfinished approval, or a permission that was not granted.
Quick checks
Section titled “Quick checks”| What you see | What to check |
|---|---|
| The app shows no Kasbly tools | The URL is exactly https://mcp.kasbly.com, the app supports remote MCP servers, and you restarted it or opened a new chat. |
| “This link can’t be used” in Kasbly | The approval screen expires after 10 minutes or was already answered. Start the connection again from the app. |
| A permission is greyed out | Your role in that workspace doesn’t allow it. Ask an owner or admin. |
| A tool you expect is missing | The connection doesn’t have that permission. Reconnect and tick it. |
| The app worked, then stopped | It was disconnected, your role changed, or you left the workspace. Connect again. |
| Wrong workspace | Disconnect the app in Settings, connect again, and choose the right workspace. |
| A draft was refused | Use an accountId from list_social_accounts, and add media for platforms that need it. |
401 errors |
The app hasn’t finished signing in. Remove Kasbly from the app, add it again and approve. |
Kasbly MCP uses sign-in (OAuth). It does not accept Kasbly API keys.
Start fresh
Section titled “Start fresh”- Remove Kasbly from the AI app.
- In Kasbly, open Settings → AI assistants (MCP) and disconnect the old connection.
- Add
https://mcp.kasbly.comto the app again. - Approve access with the right account and workspace.
- Ask “Which Kasbly workspace are you connected to?” before asking for drafts.
App notes
Section titled “App notes”| App | Note |
|---|---|
| Claude Code | Run /mcp and choose Authenticate after adding the server. |
| Codex | Run codex mcp login kasbly, then open a new thread. |
| VS Code | Switch Copilot Chat to Agent mode and enable the Kasbly tools. |
| stdio-only apps | Bridge with npx -y mcp-remote https://mcp.kasbly.com. |
Check the server
Section titled “Check the server”An unauthenticated request should return 401 with a WWW-Authenticate header that
points to Kasbly’s sign-in metadata:
curl -i https://mcp.kasbly.com \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'Still stuck? Contact us with the app name and what you see.