Skip to main content

​
Connection Issues

​
Server Not Found

Verify the MCP server URL is correct: https://mcp.tiro.ooo/mcp Common mistakes:
  • Missing /mcp path suffix
  • Using http:// instead of https://
Test connectivity: 
curl https://mcp.tiro.ooo/mcp
Expected response: 405 Method Not Allowed (this is normal for a GET request).

​
Tools Not Appearing

  1. Completely restart your MCP client (not just a window refresh)
  2. Ask your AI: “List all available MCP servers” — verify Tiro appears
  3. If still missing, re-run the Authentication setup

​
Authentication Errors

​
401 Unauthorized / 403 Forbidden

Solution: Restart your MCP client to trigger a fresh OAuth flow.
  • Claude Code: Restart the CLI session
  • Claude Desktop: Fully quit and relaunch the app
OAuth automatically issues a new token with the correct mcp:notes:read scope. Tokens are valid for 180 days.

​
Configuration Issues

​
Claude Code Fails to Connect

  1. Verify your config matches the Claude Code setup
  2. Restart the CLI session
  3. If the OAuth browser window doesn’t open, check your default browser settings

​
Claude Desktop Fails to Connect

  1. Verify your config matches the Claude Desktop setup
  2. Validate JSON syntax — check for missing commas, unmatched brackets, or missing quotes (JSONLint)
  3. Ensure Node.js is installed (npx must work in your terminal)
  4. Fully quit and restart Claude Desktop (Cmd+Q on macOS, not just close window)

​
Search & Data Issues

  • No results? Try broader search criteria — use a single general keyword in content, or widen the createdAt date range
  • Date format error? Use ISO 8601 with timezone: 2025-11-22T00:00:00Z (date-only formats are not accepted)
  • Recent notes missing? Notes may take up to 15 minutes to appear due to caching. Verify the note is “Completed” in Tiro Dashboard
  • Request timeout? Use get_note_summary instead of get_note_transcript for long meetings

​
Error Reference

CodeHTTPDescriptionSolution
UNAUTHORIZED401No valid authenticationRestart client to re-authenticate
TOKEN_EXPIRED401Token past expirationRestart client to re-authenticate
FORBIDDEN403Missing required scopeRestart client to re-authenticate
MISSING_PARAMETERS400Required params missingCheck parameter requirements
INVALID_NOTE_ID400Invalid note IDUse positive integer
INVALID_DATE_FORMAT400Wrong date formatUse ISO 8601 datetime
NOTE_NOT_FOUND404Note doesn’t existVerify note ID
INTERNAL_SERVER_ERROR500Server errorRetry or contact support
REQUEST_TIMEOUT504Request timed outUse summary or retry

​
Getting Help

GitHub Issues

Report bugs or request features

Email Support

Contact: support@tiro.ooo