Owner guide

How to connect your Lobster

This is the instruction the chat asked for. Talk to your lobster from Claude or Cursor. ChatGPT is not a working path — if it errored, that is expected.

Same character as Telegram. Copy the URL, paste it into Claude Desktop or Cursor, sign with the wallet that holds the NFT.

What this gives you

The lobster stays itself: soul, biography, and — after you sign the wallet — the same memory as the Telegram bot. You already own the NFT. This page is not how to claim a bot or open the Mini App.

Which AI to use

Same lobster wherever it actually connects. Do not buy ChatGPT or Gemini for this.

Claude Desktop
Use this
Customize → Connectors → Add custom connector → paste the URL. Sign when asked. Do not put this URL into Developer → Edit Config — that file is for local programs. Free: one custom connector; Pro or Max if you need more.
Cursor
Use this
Desktop app only — cursor.com in the browser cannot add a custom MCP. Cursor Settings → MCP → add a server → paste the URL. JSON below if you edit the file. No Claude subscription needed.
Claude.ai
Use this
Same Connectors list as Desktop — it lives on the Claude account. If it errors, use Cursor.
ChatGPT / Gemini
Does not work
No working path. Even with Developer Mode on, ChatGPT Plus has no form to add a custom MCP by URL. The error is expected — do not keep retrying there.

What you need

A Lobster NFT. The TON wallet that actually holds it — not a random one. Claude Desktop or Cursor.

Paste this URL

https://lobster.family/api/mcp/sse

This is the address of your lobster for the AI client. Transport is SSE.

How to connect

1
Copy the URL above.
2
Paste it into Claude (Connectors) or Cursor (MCP settings). Steps per app below.
3
When the app asks to authorize, sign with the TON wallet that holds the NFT and pick which lobsters to share.

Then say the number

The app does not guess which lobster is yours. Write “talk as Lobster #1234” — your real number from Telegram or the site.

Exact steps per app

Claude: Connectors, not Edit Config. Cursor: MCP settings. Not a catalogue of every AI.

Claude Desktop

Use this

Customize → Connectors → Add custom connector. Paste the URL above. When it asks to authorize, sign with the TON wallet. Do not use Developer → Edit Config for this — that file will ignore or wipe a web URL.

Cursor

Use this

Desktop app only, not cursor.com in the browser. Cursor Settings → MCP → Add new MCP server. Paste the URL. If you edit mcp.json, use the JSON below (url only).

{
  "mcpServers": {
    "lobsters": {
      "url": "https://lobster.family/api/mcp/sse"
    }
  }
}

Claude.ai

Use this

Same as Desktop: Customize → Connectors → Add custom connector → paste the URL. One custom connector on the Free plan.

Tried ChatGPT or Gemini and got an error? There is no working connector for them — ChatGPT Plus has no form to add a custom MCP even in Developer Mode. Do not keep retrying there. Connect in Claude Desktop or Cursor.

What you get after connect

get_soulget_biographyget_state
soul, biography and live state — no wallet needed.
read_memorywrite_memory
the same memory as the Telegram bot — after you sign.
roleplay_prompt
a ready-made prompt so a new chat starts in character.

If it errors

ChatGPT / GPT said error — expected. Use Claude Desktop or Cursor.
Pasted the URL into Developer → Edit Config and nothing happened, or the file reset — expected. That file does not take a web URL. Use Connectors.
Wallet window never opens — allow pop-ups for lobster.family, then try again.
"Not your lobster" — you signed a wallet that does not hold that token.
Memory tools ask you to sign. Finish TonConnect; that is not a broken connect.
The app only speaks streamable HTTP — we speak SSE. Claude Desktop or Cursor.
Authorize hangs — wait a minute and try once more. Do not mash the button.

What the AI client can see

Anyone with the token number can read soul, biography and state.

After you sign, that client can read and write the same memory as Telegram — including DMs and every group the bot has been added to, no matter who added it.

What it cannot see

Other people's private memory. Soul, biography and state are public for any number, but the memory of a lobster you did not sign for stays closed. Strangers in a group never see your DMs.

If you want to disconnect later

1
Remove the Lobsters server in that app's MCP settings.
2
The signature expires in 7 days on its own.
3
Selling the NFT cuts access on the next memory request.

In Telegram, send /connect to @LobstersManagerBot — it sends this page.