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

# Claude AI Integration

> Connect Claude.ai to analyze your Hallway research data using natural conversations

Connect Claude.ai directly to your Hallway account and analyze your research data through natural conversation. Ask Claude to summarize findings, identify themes, compare responses, or generate custom reports—all powered by your actual interview data.

## What You Can Do

With the Claude integration, you can:

* **Analyze transcripts**: "Summarize the key themes from my customer research project"
* **Find patterns**: "What do respondents say about pricing in the feedback interviews?"
* **Generate reports**: "Create an executive summary from my latest project"
* **Compare responses**: "How do enterprise customers differ from SMB customers?"
* **Extract quotes**: "Find the best quotes about user onboarding experience"

## Requirements

<Note>
  The Claude integration is available exclusively on the **Hallway Pro plan**. Free users can upgrade in Settings → Billing.
</Note>

<Note>
  You also need a Claude Pro, Max, Team, or Enterprise plan to use custom connectors. Claude.ai Free does not support custom integrations.
</Note>

Before connecting:

* A Hallway Pro subscription
* Claude Pro, Max, Team, or Enterprise subscription
* At least one project with processed interview sessions

## Connecting Claude to Hallway

<Steps>
  <Step title="Get the Server URL">
    In Hallway, go to **Settings** → **Integrations** tab. Copy the **Server URL** from the Claude MCP Connection card.

    Or use this URL directly:

    ```
    https://app.hallwayai.com/api/mcp
    ```
  </Step>

  <Step title="Open Claude Settings">
    Go to [claude.ai](https://claude.ai) and click your profile icon in the bottom-left. Select **Settings**.
  </Step>

  <Step title="Navigate to Connectors">
    In the Settings sidebar, click **Connectors** (under "Claude").
  </Step>

  <Step title="Add Custom Connector">
    Click **Add connector** and paste the Hallway Server URL. Click **Add** to continue.
  </Step>

  <Step title="Authorize Access">
    You'll be redirected to Hallway. If you're not logged in, sign in with your Hallway account.

    Review the permissions and click **Allow** to grant Claude read access to your research data.
  </Step>

  <Step title="Connection Complete">
    You'll be redirected back to Claude. The Hallway connector is now listed in your Connectors, and your Hallway **Integrations** tab will show the active connection.
  </Step>
</Steps>

## Using the Integration

### Enable in Conversations

To use Hallway data in a conversation:

1. Start a new conversation or open an existing one
2. Click the **+** button next to the message input
3. Find **Hallway** in the list of connectors and enable it
4. The Hallway icon appears, indicating it's active

<Tip>
  You need to enable the connector for each conversation where you want to use it. This ensures you control when Claude accesses your research data.
</Tip>

### Example Prompts

Here are prompts to get started:

<AccordionGroup>
  <Accordion title="List all projects">
    ```
    List all my Hallway research projects
    ```

    Claude will show your projects with names, status, and session counts.
  </Accordion>

  <Accordion title="Get project details">
    ```
    Tell me about my "Customer Discovery" project - what are the learning objectives and how many responses do I have?
    ```

    Claude retrieves project context, objectives, and statistics.
  </Accordion>

  <Accordion title="Analyze transcripts">
    ```
    Summarize the key themes from the transcripts in my "User Onboarding" project
    ```

    Claude reads all transcripts and identifies patterns across responses.
  </Accordion>

  <Accordion title="Find specific insights">
    ```
    What do respondents say about pricing? Look across all my projects.
    ```

    Claude searches transcripts for pricing-related discussions.
  </Accordion>

  <Accordion title="Generate custom reports">
    ```
    Create an executive summary of my latest research project, suitable for sharing with leadership
    ```

    Claude synthesizes findings into a formatted report.
  </Accordion>

  <Accordion title="Compare responses">
    ```
    Compare what power users versus new users say about the dashboard feature
    ```

    Claude analyzes patterns across different respondent segments.
  </Accordion>
</AccordionGroup>

## Available Data

Claude can access the following from your Hallway account:

| Data Type              | Description                                         |
| ---------------------- | --------------------------------------------------- |
| **Projects**           | Names, descriptions, learning objectives, status    |
| **Interview Sessions** | Respondent names, durations, completion status      |
| **Transcripts**        | Full conversation text from processed interviews    |
| **Insights**           | AI-extracted insights linked to learning objectives |
| **Synthesis**          | Executive summaries, key findings, emerging themes  |

<Note>
  Claude has **read-only** access. It cannot create, modify, or delete any data in your Hallway account.
</Note>

## Managing Connections

### View Your Connection

To see your MCP connection status and the server URL:

1. Log in to [app.hallwayai.com](https://app.hallwayai.com)
2. Go to **Settings** (gear icon in the sidebar)
3. Click the **Integrations** tab
4. Find the **Claude MCP Connection** card

You'll see:

* The MCP Server URL (for easy reconnection)
* Connection status (connected or not connected)
* When you connected and last used the integration
* Permissions granted

### Revoke Access

To disconnect Claude from your Hallway account:

<Steps>
  <Step title="Open Settings">
    Go to **Settings** → **Integrations** tab in Hallway.
  </Step>

  <Step title="Find Connection">
    Locate your active connection in the **Claude MCP Connection** card.
  </Step>

  <Step title="Click Revoke">
    Click the **Revoke** button next to your connection.
  </Step>

  <Step title="Confirm">
    Confirm the disconnection. Claude will immediately lose access to your data.
  </Step>
</Steps>

<Warning>
  After revoking access, you'll need to re-authorize if you want to use the integration again.
</Warning>

## Privacy & Security

### What Data is Shared

When you use the Hallway connector:

* Claude can read your projects, transcripts, and insights
* Data is transmitted securely over HTTPS
* Claude uses OAuth 2.0 for authentication (no passwords stored)
* Access tokens expire after 1 hour (automatically refreshed)

### What Data is NOT Shared

* Your Hallway password
* Other users' data (if on a team account)
* Data from accounts you don't own
* Audio recordings (only transcripts are accessible)

### Best Practices

<CardGroup cols={2}>
  <Card title="Enable per conversation" icon="toggle-on">
    Only activate the connector when needed. Keep it disabled for unrelated conversations.
  </Card>

  <Card title="Review before sharing" icon="eye">
    Before sharing Claude's analysis externally, verify the insights match your data.
  </Card>

  <Card title="Revoke when not in use" icon="shield">
    If you stop using the integration, revoke access from Settings.
  </Card>

  <Card title="Check last used date" icon="clock">
    Monitor the "last used" timestamp in Connected Apps to track access.
  </Card>
</CardGroup>

## Troubleshooting

### Connection Issues

**"Unable to connect" error**

1. Ensure you're logged into Hallway
2. Check that you clicked "Allow" on the consent screen
3. Try removing the connector in Claude and re-adding it

**Connector not appearing in Claude**

1. Verify you have Claude Pro, Max, Team, or Enterprise
2. Check that connectors are enabled in your organization (Team/Enterprise)
3. Refresh Claude.ai and try again

### Data Issues

**"No projects found"**

* Ensure you have at least one project created in Hallway
* Check that you're using the same account you authorized

**Transcripts not appearing**

* Only **processed** sessions have transcripts
* Go to your project in Hallway and process any pending sessions

**Insights seem outdated**

* Claude reads your current data each time
* Regenerate synthesis in Hallway if you've added new sessions

### Plan Requirements

**"Upgrade to Pro" message in Settings**

The Claude integration requires a Hallway Pro subscription. To upgrade:

1. Go to **Settings** → **Billing** tab
2. Click **Upgrade to Pro**
3. Complete the checkout process
4. Return to **Integrations** to set up the connection

**Redirected to settings when authorizing**

If you're redirected to the Hallway settings page instead of the consent screen, you're on the free plan. Upgrade to Pro to complete the authorization.

### Authorization Issues

**"Unauthorized" errors**

1. Your access may have expired—disable and re-enable the connector
2. Check if someone revoked access in Hallway settings
3. Re-authorize by adding the connector again

**Seeing wrong account's data**

* You may be logged into a different Hallway account
* Revoke access and reconnect with the correct account

## Limitations

Current limitations of the Claude integration:

| Limitation           | Details                                                 |
| -------------------- | ------------------------------------------------------- |
| **Read-only**        | Cannot create or modify data in Hallway                 |
| **No audio access**  | Only transcripts, not original recordings               |
| **Per-conversation** | Must enable for each conversation                       |
| **Single account**   | Cannot connect multiple Hallway accounts simultaneously |

## FAQ

<AccordionGroup>
  <Accordion title="Do I need to pay extra for this integration?">
    The Claude integration requires a Hallway Pro subscription. It's included at no extra cost with Pro—you don't pay per query or per analysis. You also need a paid Claude plan (Pro, Max, Team, or Enterprise) to use custom connectors.
  </Accordion>

  <Accordion title="I'm on the free plan—can I use this?">
    No, the Claude integration is a Pro feature. When you visit Settings → Integrations on a free plan, you'll see an upgrade prompt. Upgrade to Pro to unlock the integration along with webhooks, unlimited projects, and more.
  </Accordion>

  <Accordion title="Can Claude modify my research data?">
    No. Claude has read-only access. It can view and analyze your data but cannot create, edit, or delete anything in Hallway.
  </Accordion>

  <Accordion title="Is my data used to train Claude?">
    No. Data accessed through connectors is not used to train Anthropic's models. See [Anthropic's privacy policy](https://www.anthropic.com/privacy) for details.
  </Accordion>

  <Accordion title="Can team members see my connection?">
    Each user manages their own connections. Team members cannot see or use your personal Hallway connection.
  </Accordion>

  <Accordion title="What happens if I delete a project?">
    Claude will no longer have access to that project's data. Previously generated analyses remain in your Claude conversations.
  </Accordion>

  <Accordion title="Can I use this with Claude Desktop?">
    The integration is optimized for Claude.ai (web). Claude Desktop uses a different configuration method not currently supported.
  </Accordion>
</AccordionGroup>

## Next Steps

* [Quickstart](/docs/help/getting-started/quickstart) - Create your first Hallway project
* [Understanding Insights](/docs/help/insights/understanding-insights) - Learn about Hallway's AI analysis
* [Exporting Data](/docs/help/insights/exporting-data) - Export research reports directly