> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/support-contacts/connect-this-site-via-mcp.md).

# Connect this site via MCP

Connect supported AI tools to live Verifone documentation.

{% code title="MCP server URL" %}

```hurl
https://docs.verifone.com/~gitbook/mcp/auth
```

{% endcode %}

{% hint style="info" %}
This site requires authentication. Sign in with your Verifone account when prompted.
{% endhint %}

### Quick start

{% stepper %}
{% step %}

#### Choose your client

Add `https://docs.verifone.com/~gitbook/mcp/auth` using the instructions for your client.
{% endstep %}

{% step %}

#### Authorize access

Complete the browser sign-in flow with your Verifone account.
{% endstep %}

{% step %}

#### Verify the connection

Ask the client a specific documentation question and request a citation.
{% endstep %}
{% endstepper %}

### Before you begin

You need:

* An MCP-compatible client, such as Claude or VS Code.
* Remote MCP and OAuth support in that client.
* A Verifone account with documentation access.

The server uses published documentation. Republish changes before expecting AI tools to use them.

### Authenticate

The first connection opens a browser sign-in flow. Complete it with your Verifone account. Your client stores the authorization for future requests.

If sign-in fails, open `https://docs.verifone.com` in a browser first. Complete required SSO or multi-factor authentication. Then reconnect the MCP server.

{% hint style="warning" %}
Do not add GitBook API tokens or passwords. Use the browser authorization flow.
{% endhint %}

### Set up your client

Choose the client you use. Each configuration uses the same MCP server URL.

{% tabs %}
{% tab title="Claude" %}

1. Open **Settings** → **Connectors**.
2. Select **Add custom connector**.
3. Name it `verifone-docs`.
4. Enter `https://docs.verifone.com/~gitbook/mcp/auth`.
5. Complete the browser authorization flow.

Start a new chat after Claude connects the server. Enable the connector if Claude asks you to select available tools.
{% endtab %}

{% tab title="Claude Code" %}
Add the remote server from your terminal:

```bash
claude mcp add --transport http verifone-docs https://docs.verifone.com/~gitbook/mcp/auth
```

Start Claude Code and approve the browser authorization flow. The server becomes available under the `verifone-docs` name.
{% endtab %}

{% tab title="VS Code" %}
Create or update `.vscode/mcp.json` in your workspace:

```json
{
  "servers": {
    "verifone-docs": {
      "type": "http",
      "url": "https://docs.verifone.com/~gitbook/mcp/auth"
    }
  }
}
```

Open the **MCP Servers** view and start `verifone-docs`. Complete authentication when VS Code opens the authorization prompt.
{% endtab %}

{% tab title="Cursor" %}
Open **Settings** → **Tools & MCP**. Add a new MCP server named `verifone-docs`. Use `https://docs.verifone.com/~gitbook/mcp/auth` as the server URL. Then complete authorization.
{% endtab %}

{% tab title="Other clients" %}
Add a remote HTTP MCP server with these values:

* **Name:** `verifone-docs`
* **Server URL:** `https://docs.verifone.com/~gitbook/mcp/auth`
* **Transport:** Streamable HTTP, if the client asks

The client must support browser-based OAuth authorization. Clients without remote MCP or OAuth support cannot connect to this authenticated site.
{% endtab %}
{% endtabs %}

### Verify the connection

Start a new chat after the server connects. Ask a precise question.

{% code title="Example prompt" %}

```
Tell me Verifone's latest VAOS release and provide me a link to the latest VAOS SDK.
```

{% endcode %}

The client should use connected documentation as context. Ask for a citation to validate the result.

### Use the documentation effectively

Give the AI a focused task and name the product area. This improves retrieval quality.

* “Find the authentication flow and summarize required headers.”
* “Compare deployment options documented on this site.”
* “List the steps for upgrading to the latest version.”

Ask follow-up questions in the same conversation. The AI can retrieve more relevant pages as the task becomes specific.

### Troubleshooting

<details>

<summary>The client cannot connect</summary>

Check the URL is exactly `https://docs.verifone.com/~gitbook/mcp/auth`. Open the documentation site first. Confirm your Verifone account can access the required pages.

</details>

<details>

<summary>Authentication does not complete</summary>

Allow pop-ups for the client or browser. Complete SSO and multi-factor authentication. Remove and add the server again if the client saved expired authorization.

</details>

<details>

<summary>The client does not show documentation results</summary>

Confirm the MCP server is enabled for the current chat. Start a new chat, then ask a specific question that matches published content.

</details>

<details>

<summary>The client requests authentication</summary>

Follow the browser authorization flow. Sign in with an account that has the same documentation access you need in the browser.

</details>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verifone.com/support-contacts/connect-this-site-via-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
