# Troubleshooting & FAQ

## Common Issues

### MCP Server Not Showing Up

**Problem:** Claude/Cursor doesn't recognize the server

**Solutions:**
1. Check the config file path is correct
2. Ensure you used absolute paths (not relative)
3. Restart Claude Desktop/Cursor completely
4. Check for JSON syntax errors in config
5. Verify the build/ directory exists

### "Failed to get paste: Access denied"

**Problem:** Cannot access a paste

**Causes:**
- Trying to access a private paste without auth
- Invalid paste ID
- Paste has been deleted

**Solution:**
- Verify the paste ID is correct
- Add API token to config for private pastes

### "Invalid or expired token"

**Problem:** Authentication failing

**Solutions:**
1. Re-generate token from PasteMyst settings
2. Check token is correctly copied (no spaces)
3. Ensure token is in the "env" section of config
4. Restart the MCP client after updating token

### "Rate limit exceeded"

**Problem:** HTTP 429 errors

**Solution:**
- Wait 1 second before next request
- Avoid rapid consecutive operations
- This is a PasteMyst API limit (5 req/sec)

### Build Errors

**Problem:** `bun run build` fails

**Solutions:**
1. Delete node_modules and reinstall
2. Check TypeScript version (should be 5.x)
3. Verify all dependencies are installed
4. Try `bun install --force`

## FAQ

### Q: Do I need an API token?
**A:** No, but you'll have limited functionality. Public paste creation and viewing works without auth.

### Q: Can I edit pastes created without auth?
**A:** No, you need auth to edit/delete any paste, even public ones you created.

### Q: How do I get my paste IDs?
**A:** Use `get_user_pastes` with auth, or check your PasteMyst profile.

### Q: Can I create pastes with multiple files?
**A:** Yes! Add multiple objects to the `pasties` array.

### Q: What happens when a paste expires?
**A:** It's permanently deleted from PasteMyst servers.

### Q: Can I star pastes through MCP?
**A:** Not yet - this feature isn't in the current API wrapper.

### Q: Is my API token secure?
**A:** Yes, it's stored locally in your config and only sent to PasteMyst servers.

### Q: Can I use this with other AI assistants?
**A:** Yes! Any MCP-compatible client should work.

### Q: How do I update the server?
**A:** Pull latest changes and run `bun run build` again.

### Q: Where are logs stored?
**A:** Check your MCP client's logs (Claude Desktop logs in console).

## Getting Help

- **PasteMyst API:** https://paste.myst.rs/api-docs
- **MCP Documentation:** https://modelcontextprotocol.io
- **Issues:** File on GitHub repository

## Debug Mode

To run in development mode:
```bash
bun run dev
```

This shows detailed error messages and API responses.