> For the complete documentation index, see [llms.txt](https://docs.guestway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guestway.io/ai/guestway-mcp/how-to-connect-an-ai-assistant-with-guestway-mcp.md).
# How to connect an AI assistant with Guestway MCP
This guide shows you how to connect an AI assistant such as Claude, ChatGPT or Cursor to Guestway, so that you can ask it about your data.
{% hint style="info" %}
**Before you start**
* The Operator role or higher. See [Guestway MCP](/ai/guestway-mcp.md).
* An AI assistant on a plan that supports custom connectors. In ChatGPT, these are the paid plans Plus, Pro, Business, Enterprise and Edu.
* Your Guestway email address and password, and your authenticator app if you use two-step verification.
{% endhint %}
## Add Guestway to your assistant
{% stepper %}
{% step %}
### Open the Guestway MCP page
Go to **Settings** → **Guestway MCP**, and pick your assistant under **Connect your assistant**.
{% endstep %}
{% step %}
### Add the connector
* **Claude** (claude.ai or Claude Desktop): click **Add to Claude**. The connector opens with everything filled in. Click **Add**, then **Connect**.
* **ChatGPT:** in ChatGPT, go to **Settings** → **Apps & Connectors** → **Advanced**, and turn on **Developer mode**. Create a connector named `Guestway` with the server URL `https://mcp.guestway.io/mcp`, and choose **OAuth** as the authentication.
* **Cursor:** click **Add to Cursor**, and confirm the install.
* **Claude Code:** run `claude mcp add --transport http guestway https://mcp.guestway.io/mcp`. Then type `/mcp` in Claude Code, and choose **Authenticate**.
* **Another assistant:** click **Copy server URL**. In the connector or MCP settings of your assistant, add a remote server named `Guestway` with that URL. When asked how to authenticate, choose **OAuth**.
If you use Claude on a Team or Enterprise plan, an owner of your Claude workspace may need to add the connector first.
{% endstep %}
{% endstepper %}
## Sign in to Guestway
{% stepper %}
{% step %}
### Sign in
Your assistant opens a Guestway sign-in page in your browser. Sign in with your Guestway email address and password. If you use an authenticator app, enter its 6-digit code.
{% endstep %}
{% step %}
### Check the address
The next screen shows the name of the assistant that connects, and the web address Guestway sends you back to, for example `claude.ai` or `chatgpt.com`.
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
Always check this address. Any application can give itself any name. Only continue if the address belongs to the assistant you just started to connect.
{% endhint %}
## Choose the access permissions
{% stepper %}
{% step %}
### Choose the holding
Under **Holding**, choose the company account the connection works in.
{% endstep %}
{% step %}
### Choose the organizations
Under **Organizations**, untick the organizations you want to keep out of the assistant's reach. Use the search box if you have many.
{% endstep %}
{% step %}
### Choose about personal data
Under **Personal data**, keep **Do not allow** to hide guest names and contact details, or choose **Allow**.
If you are an Admin or Super admin and Guestway turned on the Platform API option for you, tick **Allow the Platform API proxy** and choose **Allow** under **Personal data**. The assistant can then also make changes for you.
{% endstep %}
{% endstepper %}
## Authorize
{% stepper %}
{% step %}
### Authorize the connection
Click **Authorize**. You are sent back to your assistant, and the connection is ready.
{% endstep %}
{% endstepper %}
## Troubleshooting
Why can't I connect?
Your role is below Operator. Ask an Admin of your organization to update your role.
How do I change what a connection can access?
In your AI assistant, disconnect and connect again, or choose *Reconnect* or *Re-authenticate*. The consent screen appears again, and your new choices replace the old ones.
How do I work with two holdings?
Add a second connection, for example a second connector in Claude with a different name, and choose the other holding when you sign in.
How do I disconnect an assistant?
Remove or disconnect the Guestway connector in the settings of your AI assistant.
## Related
* [Guestway MCP](/ai/guestway-mcp.md): what the connection gives you and all access permissions.
* [About Guestway MCP](/ai/guestway-mcp/about-guestway-mcp.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.guestway.io/ai/guestway-mcp/how-to-connect-an-ai-assistant-with-guestway-mcp.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.