> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyshift.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Guru Integration

> Connect your Guru knowledge base to enable Annie to search and leverage your team's internal documentation and runbooks.

# 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](https://app.anyshift.io/integrations)
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](https://developer.getguru.com/docs/guru-api-authentication).

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?