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

# Integrations

> Connect Perfai to the tools your team already uses — communication, storage, and issue tracking — so security findings flow directly into your existing workflow.

<Frame>
  <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/cc-06-integrations.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=6cd80840b57d8fc83c03ce9b95c83550" alt="Perfai Integrations page" width="1920" height="945" data-path="docs/images/cc-06-integrations.png" />
</Frame>

## What is the Integrations page?

**Integrations** connects Perfai to the tools your engineering and security teams already live in. Instead of requiring everyone to log into another dashboard, Perfai pushes findings, alerts, and reports directly to Slack, GitHub, Jira, and wherever your team works.

The integrations page is organized into three categories: **Communication**, **Storage**, and **Issue Tracking**.

***

## Communication

<Frame>
  <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/cc-06-integrations-slack.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=5631d41dc16fc1ed13b4a0211fd222bb" alt="Slack Team Activity Stream integration setup" width="1920" height="945" data-path="docs/images/cc-06-integrations-slack.png" />
</Frame>

Connect **Slack** or **Email** and Perfai streams live agent activity, security findings, and fix confirmations directly to your channel — no dashboard required.

**What gets streamed to your channel:**

<CardGroup cols={2}>
  <Card title="Agent scan start & completion alerts" icon="bell">
    Know the moment a scan begins and when results are ready — no need to check the dashboard.
  </Card>

  <Card title="Instant critical vulnerability notifications" icon="triangle-exclamation">
    Critical findings are surfaced immediately, not buried in an email digest.
  </Card>

  <Card title="Fix Agent PR confirmations" icon="code-pull-request">
    When the Fix Agent opens a PR (e.g., *PR #247: Sanitize user ID param in /users/{id}*), your team sees it the moment it lands.
  </Card>

  <Card title="Weekly security score digest" icon="chart-line">
    A regular summary of your portfolio's security posture — findings opened, fixed, and trending.
  </Card>
</CardGroup>

**Example activity stream:**

```
# activity-stream                    # security-alerts

perfai vision_agent — Discovery Agent scanned payment_api_v3,
  found 12 new endpoints  · today at 1:21 PM

perfai governance_agent — Critical — SQL injection risk in
  GET /users/{id}/profile  · today at 1:22 PM

perfai fix_agent ✓ — Fix Agent opened PR #247:
  Sanitize user ID param in /users/{id}  · today at 1:24 PM
```

<CardGroup cols={2}>
  <Card title="Slack" icon="slack">
    Post to any channel · workspace. Best for engineering teams who live in Slack.
  </Card>

  <Card title="Email" icon="envelope">
    Send alerts to your inbox. Best for executive recipients, auditors, and on-call rotations.
  </Card>
</CardGroup>

***

## Storage

<Frame>
  <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/cc-05-reports-autosync.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=39031eb8ae8daf131408d468b6559205" alt="Auto-sync reports — connect OneDrive, Google Drive, or Dropbox" width="1920" height="945" data-path="docs/images/cc-05-reports-autosync.png" />
</Frame>

Connect a cloud storage provider and every report gets synced automatically after each scan — accessible anytime, from anywhere.

<Warning>
  Reports are permanently deleted from Perfai after **14 days**. Connect a storage provider to keep them forever.
</Warning>

<CardGroup cols={3}>
  <Card title="Google Drive" icon="google-drive">
    **Connected** — Automatically save security and privacy reports to a designated Drive folder. Share with stakeholders who don't have Perfai access.
  </Card>

  <Card title="Dropbox" icon="dropbox">
    **Available** — Sync reports and findings exports to Dropbox for enhanced file management and team collaboration.
  </Card>

  <Card title="OneDrive" icon="microsoft">
    **Available** — Save and share reports within your Microsoft 365 environment via OneDrive.
  </Card>
</CardGroup>

<Note>
  Storage integrations are especially useful for compliance workflows — automatically depositing a fresh security report after every scan means your audit evidence is always up to date and accessible without manual effort.
</Note>

***

## Issue Tracking

<Frame>
  <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/cc-06-integrations-jira.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=66d1bd1b604e8a3c53485caf88cf80dc" alt="Jira and GitHub Issues — Single Source of Truth integration setup" width="1920" height="945" data-path="docs/images/cc-06-integrations-jira.png" />
</Frame>

Connect Jira or GitHub Issues and Perfai will **create, update, and close issues automatically** — your board stays accurate without any manual hygiene.

**How it works:**

```
Vuln found  →  Issue opened  →  Issue closed
```

* A new vulnerability is found → Perfai opens a ticket automatically
* The developer fixes it → Perfai re-tests on the next scan
* The fix passes → Perfai closes the ticket automatically

**Example live issue preview:**

```
● SQL Injection in GET /users/{id}/profile
  auto-created by Perfai   [Critical] [High] [Open]

● Rate limit bypass on GET /api/search
  auto-closed by Perfai    [High] [Fixed] [Closed]
```

**What's included in every ticket:**

* Issues opened on each vuln, with full exploit context
* Auto-closed when retest passes
* Zero manual issue hygiene required

<CardGroup cols={2}>
  <Card title="Jira" icon="jira">
    Cloud · Server · Data Center. Best for teams using Jira for sprint planning and backlog management.
  </Card>

  <Card title="GitHub Issues" icon="github">
    Repository · organization. Best for engineering teams whose work lives alongside the codebase.
  </Card>

  <Card title="GitHub MCP" icon="github">
    **Available** — Connect GitHub via the Model Context Protocol for deeper automation alongside your existing tooling.
  </Card>

  <Card title="Linear MCP" icon="layers">
    **Available** — Connect Linear via MCP to manage security issues alongside your product roadmap in Linear.
  </Card>
</CardGroup>

***

## Why integrations matter

Security tools fail when they create silos. If developers have to log into a separate platform to see security findings, they won't — and vulnerabilities stay open longer.

Perfai's integrations put findings where your team already is:

* A **Slack alert** the moment a Critical finding is confirmed means your team responds in minutes, not days
* A **GitHub Issue** created automatically from a BOLA finding means it's already in the sprint backlog with full reproduction details — no translation needed
* A **Google Drive report** deposited after every scan means your compliance folder is always current without manual exports

The integrations page shows which are **Connected** (active) and which are **Available** (ready to enable). Click any card to connect.

***

## Connecting an integration

<Steps>
  <Step title="Click the integration card">
    Each card shows its current status — **Connected** (green) or **Available** (grey). Click an Available card to begin the connection flow.
  </Step>

  <Step title="Authorize access">
    Most integrations use OAuth — you'll be redirected to the provider (Slack, GitHub, Google, etc.) to authorize Perfai's access. No API keys to manage manually.
  </Step>

  <Step title="Configure the destination">
    After connecting, configure where Perfai sends data — which Slack channel, which GitHub repo, which Jira project, which Drive folder.
  </Step>

  <Step title="Test it">
    Trigger a manual scan on any app and confirm findings appear in the connected tool. Most integrations push within seconds of a finding being confirmed.
  </Step>
</Steps>
