guide

Alliva in your assistant

Your assistant searches your memory, adds tasks and notes and marks things done. It can’t delete anything, and you can disconnect it any time.

Claude

Copy the address
https://api-staging.alliva.tech/mcp
The same for claude.ai and Claude Desktop.
Add a connector
In Claude open Customize → Connectors, press + Add → Add custom connector, name it Alliva, paste the address and press Continue.
The Free plan allows one custom connector. On Team and Enterprise an owner adds it in Organization settings → Connectors.
Sign in
Choose to sign in. Alliva opens: sign in, check what Claude may do and press Connect. Back in Claude, ask: What threads do I have?

Without signing in: in the same dialog, Request headers → Authorization: Bearer alv_…, with a key from Profile → Connections.

ChatGPT

Copy the address
https://api-staging.alliva.tech/mcp
ChatGPT on the web.
Add it in ChatGPT
Open chatgpt.com/plugins, press + → Add custom MCP server, name it Alliva, paste the address, set Authentication to OAuth, confirm I understand and want to continue and press Create as a plugin.
Paid plans only. In older menus it’s Settings → Apps & Connectors → Advanced settings → Developer mode → Create.
Sign in
ChatGPT opens Alliva: sign in, check what ChatGPT may do and press Connect. In a chat, @-mention Alliva and ask: What threads do I have?

ChatGPT can’t use a key: signing in is the only way.

Claude Code

Get a key
Create a key in Alliva
Profile → Connections → Create key. It’s shown once.
Paste your key
Stays on this page: never saved, never sent.
Add Alliva
Run it in the terminal:
Terminal
```
claude mcp add --transport http alliva \
  https://api-staging.alliva.tech/mcp --scope user \
  --header "Authorization: Bearer alv_…"
```
Or sign in instead of a key: claude mcp add --transport http alliva https://api-staging.alliva.tech/mcp --scope user, then type /mcp in Claude Code and choose Authenticate.
Ask
Start a session and ask: What threads do I have?
Check with claude mcp list. To disconnect: claude mcp remove alliva, or Disconnect the key in Alliva.

Cursor

Get a key
Create a key in Alliva
Profile → Connections → Create key. It’s shown once.
Paste your key
Stays on this page: never saved, never sent.
Add Alliva
Add to Cursor
Cursor adds Alliva and asks you to sign in to it, no key needed. To use your key instead, put this in ~/.cursor/mcp.json (or the project’s .cursor/mcp.json):
~/.cursor/mcp.json
```
{
  "mcpServers": {
    "alliva": {
      "url": "https://api-staging.alliva.tech/mcp",
      "headers": {
        "Authorization": "Bearer alv_…"
      }
    }
  }
}
```
Ask
In Cursor Settings → MCP make sure Alliva is on, then ask the agent: What threads do I have?
To disconnect: remove Alliva in Cursor Settings → MCP, or Disconnect the key in Alliva.

Codex

Get a key
Create a key in Alliva
Profile → Connections → Create key. It’s shown once.
Paste your key
Stays on this page: never saved, never sent.
Add Alliva
Run it in the terminal. Keep the export line in ~/.zshrc too, so the key is there after a restart:
Terminal
```
export ALLIVA_API_KEY="alv_…"
codex mcp add alliva \
  --url https://api-staging.alliva.tech/mcp \
  --bearer-token-env-var ALLIVA_API_KEY
```
Or sign in instead: codex mcp add alliva --url https://api-staging.alliva.tech/mcp, then codex mcp login alliva. The Codex app and IDE extension read the same ~/.codex/config.toml.
Ask
Check with codex mcp list, then ask: What threads do I have?
To disconnect: codex mcp remove alliva, or Disconnect the key in Alliva.

VS Code

Get a key
Create a key in Alliva
Profile → Connections → Create key. It’s shown once.
Paste your key
Stays on this page: never saved, never sent.

Add Alliva

Install in VS Code

VS Code adds Alliva and asks you to sign in to it. To use your key instead, add this to .vscode/mcp.json: VS Code asks for the key once and keeps it in its secret storage.

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "alliva-key",
      "description": "Alliva API key",
      "password": true
    }
  ],
  "servers": {
    "alliva": {
      "type": "http",
      "url": "https://api-staging.alliva.tech/mcp",
      "headers": {
        "Authorization": "Bearer ${input:alliva-key}"
      }
    }
  }
}

Ask
Open Copilot Chat in Agent mode and ask: What threads do I have?
To disconnect: remove Alliva from VS Code’s MCP servers, or Disconnect the key in Alliva.

Get a key
Create a key in Alliva
Profile → Connections → Create key. It’s shown once.
Paste your key
Stays on this page: never saved, never sent.

Add Alliva

Find your app and copy its snippet:

Windsurf · Devin Desktop

Windsurf is now Devin Desktop. Add Alliva to its MCP config:

~/.config/devin/mcp_config.json

{
  "mcpServers": {
    "alliva": {
      "serverUrl": "https://api-staging.alliva.tech/mcp",
      "headers": {
        "Authorization": "Bearer alv_…"
      }
    }
  }
}

Gemini CLI

Run it in the terminal. Without the header it signs in instead: /mcp auth alliva.

Terminal

gemini mcp add --transport http alliva \
  https://api-staging.alliva.tech/mcp \
  --header "Authorization: Bearer alv_…"

Zed

Add to Zed’s settings.json. Without headers Zed signs in instead.

settings.json

{
  "context_servers": {
    "alliva": {
      "url": "https://api-staging.alliva.tech/mcp",
      "headers": {
        "Authorization": "Bearer alv_…"
      }
    }
  }
}

Cline

Open MCP Servers → Configure and add:

cline_mcp_settings.json

{
  "mcpServers": {
    "alliva": {
      "type": "streamableHttp",
      "url": "https://api-staging.alliva.tech/mcp",
      "headers": {
        "Authorization": "Bearer alv_…"
      }
    }
  }
}

Raycast

Run Install MCP Server: transport HTTP, this address, authentication OAuth (Dynamic), then Sign In. In AI Chat, @-mention Alliva.

Server address

https://api-staging.alliva.tech/mcp

JetBrains AI Assistant

Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add, then paste:

JSON

{
  "mcpServers": {
    "alliva": {
      "url": "https://api-staging.alliva.tech/mcp",
      "headers": {
        "Authorization": "Bearer alv_…"
      }
    }
  }
}

Another client

Streamable HTTP at this address. Sign in with OAuth 2.1 (dynamic client registration), or send the header Authorization: Bearer alv_….

Server address

https://api-staging.alliva.tech/mcp

Ask
Ask: What threads do I have?
To disconnect: Disconnect the key in Alliva, Profile → Connections.

iPhone

Alliva in Claude on your phone

Add it on claude.ai
The Claude app can’t add connectors. Open claude.ai in Safari → Customize → Connectors → Add custom connector, paste the address, sign in to Alliva and press Connect.
https://api-staging.alliva.tech/mcp
Use it in Claude
The connector appears in the Claude app by itself. Ask: What threads do I have?
Keys and disconnecting
Both live in the Alliva app, Profile → Connections.
Open Connections
No app yet? The web app opens instead.
The Connections screen comes to the iOS app with the next update. Until then use the web app, app.alliva.tech: it works on the phone too.

What the assistant can do

Search your memory. Tasks, notes and threads — by words, by due date (overdue, today, this week, a range), by thread or by area. It can open a thread for an overview: open tasks, recent notes, areas, counts.
Add. One task with a due date, time and priority; one note; up to 25 tasks in one go; or a raw stream of thoughts, which Alliva sorts the usual way into tasks, notes and threads.
Update a card. Mark it done or reopen it, move or clear the due date, change the time, the priority, the title or the text.
Never delete. There is no delete tool. Whatever the assistant adds, you can undo in the app as always.
Not create threads. It can say which thread a card belongs to; the card is attached only when the name matches exactly or Alliva is confident. New threads are born the usual way, from what you capture.
Read only, if you want. A key or a connection with Read only can search but cannot add or change anything.

Dates are always in your time zone. Each answer tells the assistant today’s date, so “tomorrow” means tomorrow.

Things to ask:

What’s overdue? · What’s due this week in the Renovation thread?
Add a task: call the dentist, Thursday at 10. · Note: the plumber’s name is Marco.
Mark “buy filters” done. · Move “tax return” to next Monday.
Here is everything on my mind: … Sort it. — Alliva processes it like a recording: tasks, notes and threads appear in the app a moment later.

When the assistant is unsure which thread a card belongs to, it leaves the choice to Alliva, which sorts it in the background like any other capture. If the assistant offers you a thread and you say yes, the card is pinned to it.

About keys

Keys are created in Profile → Connections → Create key. You need an account signed in with Apple or Google: a guest account cannot connect assistants — finish signing up first.
Name a key after where it will live, for example “Claude Code on my laptop”. One key per machine means you can disconnect one without touching the others.
Turn on Read only if the assistant should only search.
The key starts with alv_ and is shown once — copy it right away. If you lose it, create a new one and disconnect the old. You can have up to 10 keys at a time.
Claude, ChatGPT and other clients that sign in through Alliva need no key.
The Connections screen comes to the iOS app with the next update; until then use the web app at app.alliva.tech, on the phone too.

Disconnecting

Profile → Connections → Disconnect next to the assistant or the key. It takes effect from the assistant’s next call; a key stops working everywhere it is used and cannot be restored.
Removing the connector inside Claude or ChatGPT also revokes its access.
Deleting your account revokes every connection and key.

What the assistant sees

Only what it asks for, one call at a time: the titles, text, dates and thread names of the cards that match. It never sees your recordings or the background structuring.
The answer lands in the assistant’s chat. Anthropic, OpenAI, Cursor and the other makers handle that chat under their own terms, not ours; our Privacy Policy covers what happens on Alliva’s servers. Alliva does not see your conversation with the assistant — only its calls.
Searching by meaning and sorting a stream of thoughts use AI processing, so they work only if you turned AI on in the app (see the AI Processing Notice). Without it, search is by words only.
We record which tool was called and whether it succeeded — never the text, the titles, the thread names or your question.
Everything runs on our servers in the EU, like the rest of Alliva.

Limits

60 calls per minute and 300 writes per 24 hours per account, across all your connections. Reading keeps working when the daily write budget is spent.
25 tasks per batch, 20 000 characters per stream of thoughts.
10 keys at a time.
A Claude.ai or ChatGPT connection renews itself while in use; after 30 days without use the assistant asks you to sign in again.

If something doesn’t work

The client says 401, “invalid token” or asks to reconnect	The key was disconnected, or the connection was revoked or unused for 30 days. Create a new key, or connect again.
“Finish signing up first” / `account_required`	You are using Alliva as a guest. Sign in with Apple or Google in the app, then try again.
`forbidden` when adding or updating	The key or connection is read only. Create a key without Read only, or connect again and allow writing.
`ai_consent_required`, or “semantic search disabled: AI processing is off”	Sorting a stream of thoughts, thread suggestions and searching by meaning need AI processing. Turn AI on in the app.
`rate_limited … retry after N s`	The per-minute or the daily limit. Wait the stated time; reading is not affected by the daily write limit.
“This link has expired” on the connect page	A connection request lives 10 minutes and works once. Start again from Claude or ChatGPT.
`consent_required`	Open the app and accept the current Terms, then try again.
`busy`	Alliva is sorting your previous capture. Try again in a few seconds.

Updated 21 October 2026. This guide is published in English, Spanish and Russian. Menu names of other products are given as they appear there and may change with their updates.

Alliva in your assistant

Claude

Copy the address

Add a connector

Sign in

ChatGPT

Copy the address

Add it in ChatGPT

Sign in

Claude Code

Get a key

Add Alliva

Ask

Cursor

Get a key

Add Alliva

Ask

Codex

Get a key

Add Alliva

Ask

VS Code

Get a key

Add Alliva

Ask

More

Get a key

Add Alliva

Ask

iPhone

Add it on claude.ai

Use it in Claude

Keys and disconnecting

What the assistant can do

About keys

Disconnecting

What the assistant sees

Limits

If something doesn’t work