Troubleshooting

​

Server Won’t Start

​

Python Version

python --version

​

Missing Dependencies

pip install -r requirements.txt

​

API Key Not Set

• In .env file: SEMUST_API_KEY=your_key_here
• Or in your AI client configuration (see Setup Guides)

​

Claude Desktop Issues

​

Tools Don’t Appear

1. Verify the path to semust_mcp.py is correct in claude_desktop_config.json
2. Use double backslashes on Windows: C:\\Users\\...\\semust_mcp.py
3. Fully quit Claude Desktop (not just close the window) and reopen it
4. Check that the JSON syntax is valid — a missing comma or bracket will break it

​

Config File Location

%APPDATA%\Claude\claude_desktop_config.json

~/Library/Application Support/Claude/claude_desktop_config.json

​

Python Not Found

{
  "command": "C:\\Python310\\python.exe",
  "args": ["C:\\path\\to\\semust_mcp.py"]
}

python -c "import sys; print(sys.executable)"

​

API Errors

​

Invalid API Key

Authentication failed — invalid API key

• Verify your key at Settings > API Key
• Check for trailing whitespace or line breaks in the key
• Ensure the key matches exactly (copy-paste, don’t type manually)

​

Integration Not Connected

​

Subscription Issues

​

Empty Data

​

No Results Returned

• Check integration status: Run list_projects and verify the integration is "completed"
• Check date range: Ensure dates are in YYYY-MM-DD format
• Search Console delay: Data has a 2-day delay — don’t use today or yesterday as end_date
• Analytics delay: GA data has a ~1-day delay
• Verify project_id: Use the exact project_id from list_projects

​

No Rank Tracking Data

• Add keywords in Semust > Rank Tracker to start tracking
• Ranking data takes 24 hours to appear after adding keywords

​

No AI Rank Tracking Data

• Add keywords in Semust > AI Rank Tracker
• AI Overview data takes 24-48 hours to appear

​

No Indexing Data

• Set up monitoring in Semust > Search Console > Indexing Monitor
• Initial crawl may take several hours

​

Getting Help

• Email: destek@semust.com
• Dashboard: app.semust.com