> For the complete documentation index, see [llms.txt](https://help.tahua.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tahua.io/knowledge-base/integrations-help-guides/ai-assistant-access/connecting-an-ai-assistant.md).

# Connecting an AI Assistant

## Step by step guide to enabling MCP access and connecting your AI assistant to Tahua.

{% hint style="info" %}
You will need an administrator account with the **Can manage Integrations** permission to follow these steps.
{% endhint %}

## Enabling hosted MCP access

{% stepper %}
{% step %}

### Navigate to the API & MCP settings

Go to **Settings > Organisation** and open the **API & MCP** tab. (This tab was previously called **API Access**.)

![](https://4124979405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F49pNEQ4fXNtxv0yJ5jgn%2Fuploads%2Fgit-blob-b572a7c1841b945d14cc826d63983db074bc9166%2Fmcp-settings-tab.png?alt=media)
{% endstep %}

{% step %}

### Enable hosted MCP access

In the **Hosted MCP access** section, select **Enabled** and click **Save changes**.

![](https://4124979405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F49pNEQ4fXNtxv0yJ5jgn%2Fuploads%2Fgit-blob-593f1c4fd8f501e9e5af3004d5314160aa5525a1%2Fmcp-enable-access.png?alt=media)

You will see the confirmation "Hosted MCP access is now enabled", and a **Connection details** section will appear below the toggle.
{% endstep %}
{% endstepper %}

## Connecting an AI app (Claude, Cursor, VS Code)

Use this option for desktop and web AI applications that support remote MCP servers.

{% stepper %}
{% step %}

### Copy your connection URL

In the **Connection details** section, make sure the **AI apps** tab is selected, then click **Copy** to copy your organisation's unique MCP URL.

![](https://4124979405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F49pNEQ4fXNtxv0yJ5jgn%2Fuploads%2Fgit-blob-bf63c328f4cbc7ffc02dcaef7721182d9e0ecce2%2Fmcp-connect-ai-apps.png?alt=media)
{% endstep %}

{% step %}

### Add the connector in your AI app

In Claude (web or desktop), go to **Settings → Connectors → Add custom connector**, paste the URL, and confirm.

Other apps that support remote MCP servers (Cursor, VS Code, and others) have an equivalent "add MCP server" option - paste the same URL there.
{% endstep %}

{% step %}

### Sign in and approve access

Your browser will open a Tahua sign-in page. Sign in with your administrator account and approve the read-only access request.

Once approved, the Tahua tools become available to your assistant and you can start asking questions about your data.
{% endstep %}
{% endstepper %}

## Connecting a command-line client (Claude Code)

Use this option for terminal-based clients such as Claude Code.

{% stepper %}
{% step %}

### Create a connection client

In the **Connection details** section, switch to the **Command line** tab and click **Create connection**.

Tahua provisions a connection client for your organisation and shows a ready-to-paste configuration block. Clicking the button again later simply shows the same details - it never creates duplicates.

![](https://4124979405-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F49pNEQ4fXNtxv0yJ5jgn%2Fuploads%2Fgit-blob-a83d71d90e01f02e0e0ea3a71eff44daec19071d%2Fmcp-connect-cli.png?alt=media)
{% endstep %}

{% step %}

### Paste the configuration into your MCP client

Copy the configuration block into your client's MCP settings. For Claude Code, it goes in the `mcpServers` section of your MCP configuration file and looks like this:

```json
"tahua-yourorganisation": {
  "type": "http",
  "url": "https://yourorganisation.api.tahua.io/mcp",
  "oauth": { "clientId": "your-client-id", "callbackPort": 49152 }
}
```

Use the exact values shown in your settings page - the URL and client ID are unique to your organisation.
{% endstep %}

{% step %}

### Connect and approve

Run `/mcp` in your client and select the Tahua server. Your browser will open - sign in as an administrator and approve the connection.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
The client ID is not a secret, but every connection still requires an administrator to sign in and approve access in the browser. Anyone connecting must have their own Tahua administrator account - access can never be shared through the configuration alone.
{% endhint %}

## Troubleshooting

* **The Connection details section doesn't appear** - hosted MCP access is disabled. Enable it as described above. If you see a message that hosted MCP is not fully configured for your tenant, contact support.
* **The browser approval fails** - make sure you are signed in as an administrator of the correct organisation, and that your account has an active administrator role.
* **The assistant says the connection is unauthorised** - the connection may have been revoked, or MCP access disabled for your organisation. Check the **Authorized connections** table in Settings, then reconnect.