Skip to main content

Guru Integration

Guru integration enables Annie to access your team’s knowledge base, allowing it to search internal documentation, runbooks, and procedures when investigating incidents or answering questions.

Setup Guide

  1. Go to the Anyshift integrations page
  2. Navigate to the Knowledge Base section
  3. Select Guru
  4. Click Connect Guru
  5. Enter your Guru Email and User Token
  6. Optionally configure a custom Base URL (for enterprise deployments)
  7. Click Save

1. Email

Enter the email address associated with your Guru account (e.g., user@company.com).

2. User Token

Generate a User Token from your Guru account:
  1. Log in to Guru
  2. Go to Manage > Apps and Integrations > API Access
  3. Click Generate User Token
  4. Copy the token and paste it into Anyshift
For more details on Guru’s authentication methods, see Guru’s API Authentication documentation. Keep your API token secure and do not share it publicly.

3. Base URL (Optional)

For most users using Guru Cloud, leave this field empty - the default URLs work automatically. If your organization uses a self-hosted Guru deployment, enter your custom base URL here. This URL is used for both:
  • Generating clickable links to Guru cards in Annie’s responses
  • Connecting to your Guru MCP server (appends /mcp to your base URL)
Example: If your self-hosted Guru is at https://guru.company.com, Annie will connect to https://guru.company.com/mcp.

Required Permissions

Annie performs read-only operations on your Guru knowledge base. Your User Token grants access to all collections you can view. Your token needs access to:
  • Knowledge agents
  • Cards and collections
  • Search functionality
Annie does not create, modify, or delete any content in your Guru knowledge base.

How It Works

Once connected, Annie can leverage your Guru knowledge base during:
  • Incident Investigation: When analyzing an incident, Annie searches your runbooks and procedures for relevant remediation steps and correlates issues with documented known problems and solutions
  • Question Answering: When you ask Annie about internal processes, it searches Guru for documented procedures

Example Use Cases

  • “What’s our procedure for Redis failover?”
  • “Search our knowledge base for Kubernetes pod restart troubleshooting”
  • “Find the runbook for database connection pool exhaustion”
Annie will search your Guru knowledge base and cite the relevant cards in its responses.

Security

  • API tokens are encrypted at rest using AWS KMS
  • Anyshift only reads from your Guru knowledge base (no write operations)
  • All communication uses HTTPS/TLS encryption
Ready to get started?