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

# Connect your AI assistant

> Use TIKT from Claude, ChatGPT, Cursor or Claude Code: read your leads, sort them, send them to your tools.

TIKT works as a connector for your AI assistant, at this address:

```
https://api.trytikt.com/mcp
```

Your assistant then reads your leads, sorts them and follows profiles for you, in your workspace only.

When you connect it, a TIKT window opens: sign in, choose **Full access** or **Read only**, and click **Allow**. With **Read only**,
your assistant reads your leads, posts and profiles, and changes nothing. Any member of the workspace can connect an assistant; when a
member does, the owner gets an email.

## Claude

### The TIKT plugin

The plugin adds the TIKT connector and three ready-made methods: sort your leads, find profiles to track, and send leads to your tools.

1. In Claude, open Customize › Plugins and click Add › Add marketplace.
2. Enter `mussetpro-ship-it/tikt-claude-plugin`, then install TIKT.
3. Open the plugin's Connectors tab and connect TIKT.

The same plugin works in Cowork. In Claude Code:

```bash theme={null}
/plugin marketplace add mussetpro-ship-it/tikt-claude-plugin
/plugin install tikt@tikt
```

Then run `/mcp` and sign in to TIKT.

### A custom connector

1. In Claude, open Customize › Connectors and click Add custom connector.
2. Paste the address, then click Add.
3. Sign in to TIKT in the window that opens.

On a Team or Enterprise plan, an owner first adds the connector in Organization settings › Connectors; members then connect it from
Customize › Connectors. On the Free plan, Claude allows one custom connector.

## ChatGPT

ChatGPT connects TIKT on the web.

1. In ChatGPT, open Plugins, click +, then Add custom MCP server.
2. Name it TIKT and paste the address as the server URL.
3. Read the warning, click I understand and want to continue, then create it as a plugin and install it.
4. Sign in to TIKT in the window that opens.

## Cursor and Claude Code

### Connect with the TIKT window

In Claude Code:

```bash theme={null}
claude mcp add --transport http tikt https://api.trytikt.com/mcp
```

Then run `/mcp` in Claude Code and sign in to TIKT. Add `--scope user` to use TIKT in all your projects.

In Cursor, add TIKT to `~/.cursor/mcp.json` for every project, or to `.cursor/mcp.json` for one project:

```json theme={null}
{
  "mcpServers": {
    "tikt": { "url": "https://api.trytikt.com/mcp" }
  }
}
```

Turn TIKT on from Customize, in Cursor's sidebar, and sign in to TIKT when Cursor asks.

### Connect with an API key

1. In TIKT, open **Settings**, then **API & MCP**, and click **Create key**. Pick **Read and write** to let your assistant sort your
   leads, or **Read only** to let it read them only.
2. Copy the key when it's shown, and keep it in an environment variable named `TIKT_API_KEY`, for example in your shell profile:

```bash theme={null}
export TIKT_API_KEY="tikt_live_EXAMPLE…"
```

In Claude Code:

```bash theme={null}
claude mcp add --transport http tikt https://api.trytikt.com/mcp --header "Authorization: Bearer $TIKT_API_KEY"
```

In Cursor:

```json theme={null}
{
  "mcpServers": {
    "tikt": {
      "url": "https://api.trytikt.com/mcp",
      "headers": { "Authorization": "Bearer ${env:TIKT_API_KEY}" }
    }
  }
}
```

Cursor reads `TIKT_API_KEY` from your environment.

## What your assistant can do

* Read your leads with their score, filter and count them, or read one of your saved views.
* Sort leads into lists, set their status (**Sent**, **Replied**…), discard them and say why, exclude a company — or add every lead
  that matches a filter to a list, up to 1,000 at a time.
* Track a profile from its LinkedIn address, pause it or archive it.
* Set up your [webhooks](https://docs.trytikt.com/webhooks/quickstart.md): create, change, turn on or off, test and delete them. Slack connects in TIKT only.
* Create, change, copy and delete your workflows, then turn them on or off, to send leads to your tools through your webhooks. A new
  workflow does nothing until it is turned on.
* Change your [ICP](https://docs.trytikt.com/help/edit-your-icp.md): it saves a new version, as **Save** does. Leads already scored keep their score.
* Decide on the competitors and customers TIKT suggested to leave out.
* Pause or resume the agent, keep or exclude a tracked profile's colleagues, and change your workspace's name, score threshold and
  company.
* Read your members and your plan. Inviting someone, paying and changing the plan stay in TIKT.

To send hundreds of leads to your sequencer, ask your assistant: it adds them to a new list, and a webhook that listens to
“lead added to a list” sends each of them to your tool within minutes. That webhook also receives leads added to your other lists.

With **Full access**, connected through the TIKT window, it can also:

* [Preview a profile](https://docs.trytikt.com/help/preview-a-profile.md) before it tracks it.
* Check what a post may cost, then [harvest it](https://docs.trytikt.com/help/analyze-a-post.md).
* [Rescore your leads](https://docs.trytikt.com/help/edit-your-icp.md#rescore-the-leads-you-already-have) after a change of ICP.
* Change your email alerts, if you are the workspace's owner.

With an API key, your assistant reads and sorts leads but can't spend credits.

Ask it for a method: “find profiles my buyers follow”, “sort my new leads”, “send my best leads to my sequence”. With the TIKT plugin,
Claude has them ready.

## Credits and limits

* Your assistant shows the cost before it spends.
* Checking what a post may cost and previewing a profile are free, up to 100 a day in total.
* Harvests and rescores use credits, as in TIKT, up to the daily limit for assistants: 20% of your monthly credits unless the owner
  changes it in **Settings**, then **API & MCP**. Harvests you start in TIKT don't count.
* Its previews count toward the [35 profiles a month](https://docs.trytikt.com/help/preview-a-profile.md) you can preview without tracking them.
* A profile it tracks is harvested by TIKT like any profile you track, and uses credits the same way.
* It follows no more profiles than your plan includes ([how many profiles you can follow](https://docs.trytikt.com/help/choose-profiles.md#how-many-profiles-you-can-follow)).
* It counts toward your workspace's [API limits](https://docs.trytikt.com/api/rate-limits.md): 120 reads and 30 changes a minute, 20,000 calls a day.
* When many people use TIKT at the same time, TIKT may ask your assistant to wait 10 seconds. Nothing was done: it can ask again.
* Text from LinkedIn is written by other people: TIKT marks it, and tells your assistant never to follow instructions found in it. A
  harvest always needs a cost check first, and stays within the daily limit.

## Disconnect

In **Settings**, then **API & MCP**, click **Disconnect** next to the assistant, or **Revoke** next to the key. Your assistant can no
longer use TIKT. An assistant is also disconnected when the person who connected it leaves the workspace.

To switch between **Full access** and **Read only**, disconnect your assistant, then connect it again: TIKT asks again.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.