> ## 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

### Option A: Connect with Guru (recommended)

1. Go to the [Guru integration page](https://app.anyshift.io/integrations/knowledge/guru).
2. Click **Connect with Guru**.
3. Sign in to Guru (if needed) and authorize Anyshift.
4. You are redirected back to Anyshift with Guru connected.

OAuth uses Guru's MCP Dynamic Client Registration flow. Access is scoped to the authorizing Guru user's permissions. You can disconnect at any time from the Anyshift integration page.

> **Note:** Guru may require Support to whitelist Anyshift redirect URIs before OAuth works in a given environment. If authorize fails before consent, contact Guru Support (or Anyshift) to confirm the whitelist.

### Option B: Email + User Token

Use this if you prefer a static token or OAuth is not available yet.

1. Go to the [Guru integration page](https://app.anyshift.io/integrations/knowledge/guru).
2. Click **Connect Guru** (or **New credentials**).
3. Enter your **Guru Email** and **User Token**.
4. Optionally configure a custom **Base URL** (for enterprise deployments).
5. 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?