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

# Claude Plugin

> Bring Addison into Claude Code and Claude Desktop — ask data questions, generate and validate reports, explore your catalog without leaving Claude.

The Addison plugin puts Summation's AI data analyst directly inside Claude. Setup takes about two minutes and one browser sign-in — no API keys, and no secrets ever pasted into chat. Everything Addison does runs as **you**, against **your** Summation workspace.

## Claude Code

Anyone can install the plugin themselves from a Claude Code session — no admin required.

<Steps>
  <Step title="Add the Summation marketplace">
    ```text theme={null}
    /plugin marketplace add summationai/addison-plugin
    ```
  </Step>

  <Step title="Install the plugin, then restart Claude Code">
    ```text theme={null}
    /plugin install addison@summation
    ```

    Restart Claude Code so the plugin loads.
  </Step>

  <Step title="Sign in">
    ```text theme={null}
    /addison:login
    ```

    Addison shows a sign-in link and a short verification code:

    ```text theme={null}
    Open this link and approve to connect Claude to Summation — it expires in 10 minutes.
    https://app.summation.com/device?code=WXYZ-1234
    Verification code: WXYZ-1234
    ```

    Open the link, approve in your browser, and you're connected. The Summation data tools wire up automatically.
  </Step>

  <Step title="Take the tour">
    ```text theme={null}
    /addison:start
    ```

    A guided first run: a map of your connected data, an introduction to Addison, and your first report.
  </Step>
</Steps>

### Commands

| Command             | What it does                                             |
| ------------------- | -------------------------------------------------------- |
| `/addison:start`    | Guided onboarding — data map and first report            |
| `/addison:report`   | Generate a report and export it (PDF, DOCX, or Markdown) |
| `/addison:query`    | Run a read-only query and see results as a table         |
| `/addison:catalog`  | Search your tables, views, and schemas                   |
| `/addison:validate` | Fact-check a report against its sources before sharing   |
| `/addison:logout`   | Disconnect and remove the stored credential              |

You don't need commands for most work — just ask data questions in plain English and Addison picks them up.

## Claude Desktop

On Claude Desktop (including Cowork), plugins are managed per organization: a Claude admin enables Addison once, then every member installs it from the org library.

### For your Claude organization admin

<Steps>
  <Step title="Add Addison from GitHub">
    Go to **claude.ai → Orgranization settings → Plugins → Add plugins, select Sync from Github (you have to fork this [repo](https://github.com/summationai/addison-plugin) or upload the zip file available on the plugin [releases page](https://github.com/summationai/addison-plugin/releases).**

    <Frame>
      <img src="https://mintcdn.com/summation-676748f5/ewrpxeNnW54PEh54/images/integrations/claude-plugin/sync-from-github.png?fit=max&auto=format&n=ewrpxeNnW54PEh54&q=85&s=d491a5efb75b347bd0286a56ee86cc12" alt="The Claude.ai organization Plugins settings, Add plugins dialog with the Sync from GitHub option selected and a field for the forked addison-plugin repository" width="1140" height="814" data-path="images/integrations/claude-plugin/sync-from-github.png" />
    </Frame>

    If you want to upload the plugin as a zip file:

    <Frame>
      <img src="https://mintcdn.com/summation-676748f5/ewrpxeNnW54PEh54/images/integrations/claude-plugin/upload-zip.png?fit=max&auto=format&n=ewrpxeNnW54PEh54&q=85&s=540b8a6f1fb71929e9f1940832167666" alt="The Add plugins dialog with the upload option selected, accepting a zip file downloaded from the addison-plugin releases page" width="1128" height="1010" data-path="images/integrations/claude-plugin/upload-zip.png" />
    </Frame>

    Once, it is installed, make sure to select the appropriate User access:

    <Frame>
      <img src="https://mintcdn.com/summation-676748f5/ewrpxeNnW54PEh54/images/integrations/claude-plugin/user-access.png?fit=max&auto=format&n=ewrpxeNnW54PEh54&q=85&s=b4cd0ab7112be778fe9992bea6ba4fa7" alt="The installed Addison plugin settings showing the User access control that governs which organization members can install and use it" width="2658" height="316" data-path="images/integrations/claude-plugin/user-access.png" />
    </Frame>
  </Step>

  <Step title="Allow network access to Summation">
    Addison's helper runs in Claude Desktop's code-execution sandbox, which blocks outbound network access by default. Under **Admin settings → Capabilities → Code execution → Network access**, allow both hosts:

    ```text theme={null}
    api.summation.com
    mcp.summation.com
    ```

    <Frame>
      <img src="https://mintcdn.com/summation-676748f5/ewrpxeNnW54PEh54/images/integrations/claude-plugin/network-access.png?fit=max&auto=format&n=ewrpxeNnW54PEh54&q=85&s=e9138f71297fe895f16de01344be0672" alt="Claude Desktop Admin settings, Code execution Network access panel with api.summation.com and mcp.summation.com added to the allowed hosts." title="Allowing network access to Summation" width="2650" height="702" data-path="images/integrations/claude-plugin/network-access.png" />
    </Frame>
  </Step>

  <Step title="Publish to your organization">
    Publish Addison to the org library so members can install it.
  </Step>
</Steps>

### For team members

<Steps>
  <Step title="Install from your org library">
    In Claude Desktop, open **Settings → Plugins → Brown**, find **Addison** in your organization's library, and install it by clicking on the (+) icon.

    <Frame>
      <img src="https://mintcdn.com/summation-676748f5/ewrpxeNnW54PEh54/images/integrations/claude-plugin/install-from-library.png?fit=max&auto=format&n=ewrpxeNnW54PEh54&q=85&s=1d942e5c054e8251e4bd383ca2796d12" alt="Claude Desktop Settings, Plugins view showing Addison in the organization library with the plus icon used to install it" width="2012" height="854" data-path="images/integrations/claude-plugin/install-from-library.png" />
    </Frame>
  </Step>

  <Step title="Start and sign in">
    Open a new chat and type `/addison:login`. Approve the sign-in link in your browser and Addison shows a map of your data.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="/addison:login fails immediately on Desktop">
    Almost always the network allowlist. Ask your Claude admin to confirm `api.summation.com` is allowed under **Code execution → Network access**.
  </Accordion>

  <Accordion title="&#x22;Not signed in to Summation. Run /addison:login to connect.&#x22;">
    Your session expired or was never completed. Run `/addison:login` again — it takes seconds.
  </Accordion>

  <Accordion title="A report or query is taking a while">
    Report generation and validation are thorough and can take a minute or two. Addison tells you it's working — this is normal, not a hang.
  </Accordion>

  <Accordion title="Desktop asks me to sign in again in a new conversation">
    On Claude Desktop, credentials live in the per-conversation sandbox and don't always carry over. Re-running `/addison:login` reconnects in seconds. A one-click connector sign-in is coming — see [MCP Server](/integrations/mcp-server).
  </Accordion>

  <Accordion title="I need automation or a non-production environment">
    The plugin is production, browser-sign-in only — the right default for almost everyone. For machine-to-machine access, see [Public API](/integrations/public-api) or contact your Summation representative.
  </Accordion>
</AccordionGroup>