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

# Set up in Claude

> Connect the Kowalah MCP connector to Claude so your team can access projects, skills, and Expert Requests directly.

Connect Kowalah to Claude so your team can access your organization's projects, accelerators, and Expert Requests directly from Claude on the web or desktop.

## Admin setup

A Claude workspace administrator adds the Kowalah connector once for the whole organization.

<Steps>
  ### Open organization settings in Claude

  Go to your Claude **Organization Settings** and find the **Connectors** section.

  ### Add a custom web connector

  Click to add a new custom web connector and enter this URL:

  ```text theme={null}
  https://mcp.kowalah.com/api/mcp
  ```

  Name it **Kowalah**.

  ### Save

  The connector is now available for everyone in your Claude organization.
</Steps>

## Individual user setup

Once the admin has added the connector, each person authenticates with their own Kowalah account.

<Steps>
  ### Go to your personal settings in Claude

  Open your Claude **Settings** and find the **Connectors** or **Integrations** section. You should see Kowalah listed.

  ### Authenticate

  Click to connect and sign in with your Kowalah credentials — the same login you use for [app.kowalah.com](https://app.kowalah.com). This is a one-time authorization.

  <Note>
    If you don't have a Kowalah account yet, one will be created automatically when you authenticate.
  </Note>

  ### Verify the connection

  You should see Kowalah's tools available in Claude. Try asking:

  ```text theme={null}
  List my Kowalah projects
  ```
</Steps>

## Using Kowalah in Claude

Once connected, ask Claude natural language questions and it will call the appropriate Kowalah tools.

### See what's waiting for you

The fastest way to get oriented in Claude is to ask for an update with no specifics. The connector returns a role-appropriate rollup of your work, plus any [Discovery](/platform/discoveries) briefs you've been invited to respond to.

```text theme={null}
What's pending for me in Kowalah?
```

```text theme={null}
Do I have any discovery invites waiting?
```

```text theme={null}
What's the status of my projects?
```

The response includes a `pending_discoveries` section showing each brief, its goal, the business value context, and when it closes. You only see invites you're personally on — never anyone else's.

### Get a focused view

Ask about a specific project, deliverable, Expert Request, or opportunity by name or by reference number (`PRJ-…`, `DEL-…`, `ER-…`, `OPP-…`):

```text theme={null}
How's the Finance Automation project going?
```

```text theme={null}
What's ER-42 doing?
```

### Submit an opportunity

Anyone in your organization can raise an [Opportunity](/platform/opportunities) directly from chat. You don't have to decide whether it's an Expert Request, a deliverable, or a project — Kowalah's team triages it after submission.

```text theme={null}
I want to raise an opportunity with Kowalah about cleaning up
the way we onboard new suppliers
```

Claude will check the accelerator library first, walk you through goal and context, then submit the opportunity and give you back the opportunity number.

<Tip>
  You can also pick **Submit an opportunity** from Claude's prompt menu to start the guided submission flow directly. It accepts an optional one-liner to seed the conversation.
</Tip>

### Respond to a discovery

If Claude has shown you a pending discovery in your update, just tell it which one you want to respond to:

```text theme={null}
I want to respond to the supplier onboarding discovery
```

Claude links your opportunity back to the discovery brief, copies the project linkage across, and marks your invite as responded so reminders stop.

## Multiple organizations

If you belong to multiple Kowalah organizations, the connector provides access to all of them. Specify which organization you mean if it's ambiguous:

```text theme={null}
List projects in my Acme Corp organization
```

## Troubleshooting

### Authentication failed

Make sure you're signing in with the same account you use at [app.kowalah.com](https://app.kowalah.com). If you use Google sign-in on the platform, use the same Google account here.

### Tools not appearing

Try disconnecting and reconnecting the Kowalah connector. If tools still don't appear, check that your Kowalah account has an active organization membership.

### "No organizations found"

Your Kowalah account doesn't have any accepted organization memberships. Ask your organization admin to invite you, or sign up at [app.kowalah.com](https://app.kowalah.com) first.

<Card title="Available tools" icon="wrench" href="/integrations/mcp/available-tools">
  See the full list of tools and what each role can access
</Card>