Troubleshooting

OAuth Issues

"Token expired"

Your OAuth token has expired. The agent should automatically re-trigger the OAuth flow. If not:

1. Check your MCP client handles AUTH_REQUIRED errors
2. Manually re-authenticate by restarting your AI tool

"OAuth flow not opening"

The browser-based OAuth flow isn't starting:

• Check popup blockers in your browser
• Ensure your firewall allows outbound connections to beta.engrammic.ai
• Try a different browser

"Invalid redirect"

The OAuth callback URL doesn't match:

• Verify your MCP config points to https://beta.engrammic.ai/mcp/
• Check for typos in the endpoint URL

Connection Issues

"Cannot connect to MCP"

• Verify endpoint: https://beta.engrammic.ai/mcp/
• Check network connectivity: curl -I https://beta.engrammic.ai/mcp/
• Restart your AI tool after config changes

"Timeout"

The beta service might be under load:

• Retry after a few seconds

Tool Errors

"Node not found"

The referenced node_id doesn't exist:

• The node may have been deleted via forget
• Check for typos in the node_id
• Use recall to find the correct node

"Validation error"

Required parameters are missing or malformed:

• remember requires content
• learn requires claim and evidence
• believe requires conclusion, about, and reasoning
• Check parameter types (strings vs arrays)

"Rate limited"

You've exceeded the request limit:

• Back off for 60 seconds
• Consider batching operations

Multi-Agent Issues

"Can't see other agent's data"

Make sure both agents are connected to the same Engrammic endpoint URL.

Getting Help

Technical support: dev@engrammic.ai

General inquiries: founders@engrammic.ai

Include in bug reports:

• Error code and message
• What operation you were attempting
• Your tool (Claude Code, Cursor, etc.)
• Anonymized request/response if possible