# Install Tidio with Cursor

Section: Install Tidio

Description: Connect Cursor to the Tidio Help Center, add the chat widget to your repository, and keep its installation instructions in a project rule.

Verified against Tidio panel 12.331.0

Last updated: 2026-11-18

Source: https://help.tidio.com/articles/install-cursor/

Use Cursor to add the Tidio chat widget to your repository. Connect the Tidio Help Center so the agent can read the installation guide for your framework before changing your code.

**In this article, you'll learn:**

- [How to find your Public key](https://help.tidio.com/articles/install-cursor/#public-key)
- [How to connect the Tidio Help Center](https://help.tidio.com/articles/install-cursor/#docs-for-ai)
- [How to ask Cursor to add the widget](https://help.tidio.com/articles/install-cursor/#prompt)
- [How to keep the rule in your project](https://help.tidio.com/articles/install-cursor/#keep-instructions)
- [How to check the installation](https://help.tidio.com/articles/install-cursor/#check)
- [How to troubleshoot the installation](https://help.tidio.com/articles/install-cursor/#troubleshooting)

[Video](https://help.tidio.com/article-media/install-cursor/walkthrough.mp4)

Silent walkthrough. Open Developer settings and select your project's Public key.

## Find your Public key

Log in to your Tidio panel and go to **Settings > Developer > Project data**. Click the **Public key** field to select its value, then copy it.

![The Project data page with the Public key field, masked private key and Visit widget SDK documentation button visible](https://help.tidio.com/article-media/install-cursor/project-data-public-key.png)

The Public key is part of the script address that every visitor's browser loads, so you can keep it in front-end code. The private key on the same page is different: never put it in your website.

You'll find the same key inside the installation code in **Settings > Live Chat > Installation**, under **Manual install**:

```
<script src="//code.tidio.co/YOUR_PUBLIC_KEY.js" async></script>
```

![Settings > Live Chat > Installation with Manual install selected, the code snippet visible, and the Copy to clipboard button.](https://help.tidio.com/article-media/install-cursor/installation-manual-install.png)

## Connect the Tidio Help Center

The Tidio Help Center provides a read-only MCP server at ` https://help.tidio.com/mcp `. It uses Streamable HTTP and requires no login. Cursor supports remote MCP servers with this transport.

Create ` .cursor/mcp.json ` in your project with this content. If the file already exists, add the ` tidio-help-center ` entry inside its existing ` mcpServers ` object instead of replacing your other servers.

```
{
  "mcpServers": {
    "tidio-help-center": {
      "url": "https://help.tidio.com/mcp"
    }
  }
}
```

Open **Customize** from Cursor's sidebar to manage MCP servers, and enable ` tidio-help-center ` there.

The Tidio server provides ` search_articles `, ` get_article `, ` list_articles `, ` list_sections `, and ` get_section `. Ask the agent to use ` search_articles `, then ` get_article `, to read your framework's guide before you send the installation prompt.

If MCP is unavailable, give the agent ` https://help.tidio.com/llms.txt ` as the documentation index. If it cannot fetch the index, paste the matching framework guide into the conversation instead.

## Ask Cursor to add the widget

Replace ` YOUR_PUBLIC_KEY ` with your Public key, then paste this prompt into Cursor's Agent chat:

```
Add the Tidio live chat widget to this project.

1. Load this script once on every page, at the end of the body, with async:
   <script src="//code.tidio.co/YOUR_PUBLIC_KEY.js" async></script>
2. Put it in the root HTML document or the root layout, so it loads once and stays loaded during client-side navigation. Do not add it to single pages or to a component that mounts more than once.
3. Do not install an npm package for Tidio. The script tag is the whole installation.
4. Do not use window.tidioChatApi on the server. Use it only in the browser, after the "tidioChat-ready" event fires on document.
5. Change nothing else, then tell me which file you edited.

Reference: https://help.tidio.com/articles/install-ai-coding-agents/
```

Review the changed file before deploying. For the exact code to review or add yourself, choose your framework guide:

- [Next.js](https://help.tidio.com/articles/install-nextjs/)
- [React](https://help.tidio.com/articles/install-react/)
- [React Router and Remix](https://help.tidio.com/articles/install-react-router/)
- [TanStack Start](https://help.tidio.com/articles/install-tanstack-start/)
- [Vue](https://help.tidio.com/articles/install-vue/)
- [Nuxt](https://help.tidio.com/articles/install-nuxt/)
- [SvelteKit](https://help.tidio.com/articles/install-sveltekit/)
- [Astro](https://help.tidio.com/articles/install-astro/)
- [Angular](https://help.tidio.com/articles/install-angular/)
- [Gatsby](https://help.tidio.com/articles/install-gatsby/)
- [SolidStart](https://help.tidio.com/articles/install-solidstart/)
- [Qwik](https://help.tidio.com/articles/install-qwik/)
- [Eleventy](https://help.tidio.com/articles/install-eleventy/)

## Keep the rule in your project

Cursor project rules live in ` .cursor/rules ` and use the ` .mdc ` extension. Create ` .cursor/rules/tidio.mdc ` with this content:

```
---
alwaysApply: true
---

Before changing the Tidio integration, read the matching framework guide from the Tidio Help Center MCP server, or use https://help.tidio.com/llms.txt if MCP is unavailable.
Keep the Tidio script in one root document or layout, use only the Public key, and do not add an npm package for Tidio.
```

The ` alwaysApply: true ` frontmatter includes the rule in every chat session. Keep the file with your project so future edits have the same Tidio instructions.

## Check the installation

Open your site in a regular browser window. The chat widget appears in the corner of the page and stays there when you move between pages. Headless and automated browsers may not show the widget, so do not rely on them for this check.

Loading a page with the widget is what activates it. After that, **Settings > Live Chat > Installation** in your Tidio panel says **Chat Widget is installed properly**.

Check the deployed site, then move to another page and back to check that navigation does not add another widget script.

## Troubleshoot the installation

- If the agent cannot find the Help Center tools, confirm that ` .cursor/mcp.json ` contains the server entry and check that it is enabled in **Customize**. Use the documentation index fallback if you cannot connect.
- If the widget does not load, check that you replaced ` YOUR_PUBLIC_KEY ` and copied the whole Public key.
- If you see two widgets or duplicate script requests, ask the agent to remove the extra installation rather than adding another script.
- If server rendering reports that ` window ` or ` document ` is undefined, ask the agent to move browser-only code to the framework's client-side lifecycle.
- If your Content Security Policy blocks Tidio, allow ` code.tidio.co ` in ` script-src ` and add the other hosts from the [Content Security Policy](https://developers.tidio.com/docs/widget-security-policy) page of the developer documentation.
- If an automated check cannot see the widget, repeat the check in a regular browser window.

## Further reading

- [Install Tidio with an AI coding agent](https://help.tidio.com/articles/install-ai-coding-agents/)
- [Install Tidio on your website](https://help.tidio.com/articles/install-website/)
- [Widget SDK](https://help.tidio.com/articles/widget-sdk/)
- [Cursor MCP documentation](https://cursor.com/docs/mcp)
- [Cursor project rules](https://cursor.com/docs/rules)
