Skip to main content
This page is optional and only applies if you connect your assistant (Claude, ChatGPT or Codex) to your business from outside the dashboard. If you work only in the dashboard, you don’t need it.
The connection URL is the address you paste into your assistant to connect it to your business. With it you choose what you offer it: just looking, editing the catalog, answering chats, testing the agent… What your assistant can actually do doesn’t depend on the URL alone. Your permissions, the business the connection works in and some usage limits count too. You’ll see this in What the URL does not decide. The dashboard interface is in Spanish, so its buttons and menus are named here in Spanish with the English meaning in parentheses.

​
The URL, bare and complete

The base is this one:
Like that, with nothing else, it already works. It brings your business’s reads — your funnels, the playbook, the catalog, the conversations and the customers — and three minor writes: creating customer tags, changing a customer’s tags and logging a request your assistant couldn’t fulfill, which reaches us so we can build what’s missing. The one the dashboard gives you is the complete one. It’s in Personalizar → Asistentes IA (“Customize → AI assistants”), with the Copiar link (“Copy link”) button:
Conecta tu asistente (Connect your assistant) card in Personalizar, Asistentes IA, with the connection link, the Copiar link button, three numbered steps and a note about read-only mode

The «Conecta tu asistente» (Connect your assistant) card: the full link, the «Copiar link» (Copy link) button, the three steps and, at the bottom, how to make it read-only.

If you don’t see Personalizar in your menu, copy the URL from here: it’s the same one.

​
How to build it

1

Start from the base

https://mcp.darkfunnels.ai/mcp, or the dashboard’s, which already comes with ?features=all.
2

Choose which groups travel

Add ?features= with the groups separated by commas, or all for all of them. The groups are in the next section.
3

Add the other parameters

The first one goes after ? and the following ones after &. For example: ?features=all&read_only=true.
4

Connect

Paste it as a new connector in your assistant and authorize with your account. If you already had it connected, see Changing the URL afterwards.
If you add a parameter, keep the ones you already had: it’s the most common mistake when reconnecting. And write the values in lowercase and exactly as they appear here: with ALL, True or FULL, the parameter has no effect.

​
?features= — which tool groups travel

The bridge’s tools come in groups. Without this parameter, the default set travels: core, manual, catalog and conversations, plus the reads of some apps that only appear in certain accounts. Everything else has to be asked for. If your account has one of those apps and you use a list, name its group too: you’ll find it in the Tools reference. The last column says which access you need in your business. They are the names of the switches in Personas y accesos (“People and access”). Included by default You have to ask for these
An explicit list REPLACES the default set, it does not extend it. Connecting with ?features=orders leaves you with orders and core only: you lose playbook, catalog and conversations.To add without losing anything, the simplest option is ?features=all. If you prefer a list, also name the ones that came by default: ?features=manual,catalog,conversations,orders.
Three more details:
  • core travels with any URL, even if you don’t name it.
  • Writing brings reading. manual_write also brings manual, and catalog_write brings catalog: to rewrite something, your assistant has to be able to read it first.
  • A misspelled name is ignored without warning. If no valid one is left in your list, you go back to the default set.
?features=all turns on all the groups, including the ones we publish later on. It’s the URL the dashboard gives you and the one in the quickstarts: the one you don’t have to touch again. all doesn’t give you more permissions. Out of all those groups, your assistant gets only what your account can use in that business. In exchange, it also connects the destructive writes. Those actions travel marked as destructive, and assistants usually use that mark to ask you for confirmation. If you want it only to look, add &read_only=true.

​
?read_only=true — the handbrake

It disables every write and overrides any other option, all included. It’s for letting your assistant look without being able to touch.
These count as writes, so they don’t travel either: asking the copilot, optimizing the playbook with AI, opening the test chat, logging a request and reading the text of a Library file (with an image it spends credits).
Any value turns it on: true, 1, TRUE or yes mean read-only. Only false, 0, no or off leave it off, and when a value can’t be understood the bridge stays read-only: when in doubt, it doesn’t write.

​
?pii=full — full phone numbers

By default, your customers’ phone number arrives masked: 51•••••4321. It keeps the country hint and the last four digits, enough to recognize a number you already know. With pii=full it arrives whole:
The masking applies to the conversation list, the customer list, a customer’s profile and orders. What gets masked is the phone number. The name, the ID document and the address on an order, and what your customers write in their messages, arrive as they are. Having it masked hardly gets in the way. The tools that act on a chat find it by the conversation, not by the number. The ones that do ask for a number — simulating a new chat or changing the number lists in the funnel’s settings — ask you for it, and you type it yourself. What you lose is convenience, in two ways: your assistant can’t give you the full number (the panel does show it), and although customer search accepts a phone number, a masked number can’t be used to search. Any misspelled variant, like pii=FULL, leaves the phone masked. The details and the why, in Security.

​
?agent=<uuid> — pinning a funnel

If you have several funnels, almost every tool needs to know which one you mean. This parameter sets one as the connection’s default funnel, and your assistant stops asking you. With a single funnel you don’t need it: that one is used.
Your own assistant gives you the identifier: ask it “give me my funnels’ identifiers”. It has to be complete, with its hyphens. If it doesn’t have that shape, it’s ignored without warning and your assistant asks you about the funnel again. Pinning it doesn’t lock you in: if you expressly ask for another funnel, it works with that one.

​
What the URL does not decide

​
Your permissions and your business’s apps

Your assistant gets in with your account and with your permissions. Of what the URL asks for, it gets the tools of the apps that you can use in that business and that the business has active. And if another one ever appeared to it, it couldn’t use it. It’s the rule of your dashboard menu: whatever your account can’t open there, your assistant can’t use either. That’s why two people with the same URL can see different lists. For example, someone on your team who only has Órdenes, connected with the bare URL, sees only the basics: who they are, which business they work in, the quick product help and logging requests. To read orders they need ?features=orders or all. For stock, they also need access to Inventario.
  • If your assistant tries a tool without permission, or from an app that’s switched off, it gets a notice that it doesn’t have that access and does nothing. The notice may name the app differently from the switch: for orders it says «Pedidos», while the switch is called Órdenes (both mean “Orders”); for the balance it says «Saldo y consumo» (“Balance and usage”), while the switch is Ver saldo y facturación.
  • Permissions are given by whoever manages your team, in Personas y accesos. Apps are switched on in Administración → Apps (“Administration → Apps”).
  • If you were just given a permission, wait a minute and open a new chat in your assistant.

​
The business the connection works in

If your account is in several businesses, each connection stays pinned to the business you had active when you connected it, and it works with your permissions in that business. If your account is in only one, this changes nothing for you. If your active business changes later on, because you chose another one in your account menu or because you accepted another business’s invitation (when you accept it, that business becomes the active one):
  • Its writes are rejected without running, so that nothing gets saved in the wrong business. The notice says which business the connection works in and which one you have active now.
  • Its reads keep working, but they show the data of the business you have active now.
After switching business, what your assistant reads is already from the other one. If you were comparing figures, first go back to the connection’s business.
To make it save changes again, do one of two things:
  1. Choose that business again in your account menu, with Cambiar a esta empresa (“Switch to this business”). The connection carries on as before, without reconnecting.
  2. Disconnect the connector and connect it again. The new connection stays pinned to the business you have active when you connect it: if you want to work in another one, switch first in your account menu.
If your access to the connection’s business is removed, its writes are rejected too. To work in another business, disconnect and connect again. Not sure where it’s working? Ask it “which business are you working in?”. It has a tool for that, which also says which permissions it works with and whether the active business is still the connection’s.

​
Usage limits

  • Per account. If your assistant goes over 60 requests in a minute or 300 in an hour, the bridge holds it back and replies «rate limit; reintenta en N s» (“rate limit; retry in N s”). It counts what you do with all your assistants together. It happens above all with batch jobs, like reviewing hundreds of chats in a row. The wait is the one N says: a few seconds if it went over the per-minute cap, and up to an hour if it went over the hourly one. For big jobs, ask it to go in parts.
  • Per business. There’s a daily quota of tool calls — by default, 20,000 — that resets at midnight, Lima time. If it runs out, your assistant tells you. If your business needs more, write to us.

​
Changing the URL afterwards

Changing any of these parameters requires reconnecting: in your assistant, delete the connector you had and add it with the new URL. Careful if you’re in several businesses: the new connection stays pinned to the business you have active when you connect it. Choose the business in your account menu first. Don’t confuse that with new tools. The tool list is frozen per conversation: if we add one, or you were just given a permission, and it doesn’t show up, opening a new chat is normally enough. If it still doesn’t show up in a new chat, delete the connector and connect it again. Reconnecting is needed when the URL changes, when you want the connection to work in another business and after revoking access.

​
Cutting off access

1

Open Asistentes IA

In the dashboard, go to Personalizar → Asistentes IA and scroll down to the Seguridad y acceso (“Security and access”) card.
2

Click Revocar

Under Asistentes con acceso a tu cuenta (“Assistants with access to your account”) you see each assistant you authorized, with the date. Click Revocar (“Revoke”) next to the one you want to cut off and confirm with Revocar.
3

Done

That assistant loses access to your account within a few seconds. To use it again, you’ll have to connect it again.
Personalizar is part of Ventas: if you don’t see it in your menu, ask whoever manages your team for access to Ventas so you can revoke from here. In the meantime, remove the connector in your assistant.
Seguridad y acceso (Security and access) card with three bullet points about the connection and the Asistentes con acceso a tu cuenta (Assistants with access to your account) list, which reads Ningún asistente tiene acceso a tu cuenta ahora (No assistant has access to your account right now)

«Seguridad y acceso» (Security and access): how the connection is protected and the «Asistentes con acceso a tu cuenta» (Assistants with access to your account) list. In this screenshot it is empty; each assistant you authorize shows up there with its «Revocar» (Revoke) button.

Revoking cuts off the access, but the connector stays in your assistant. To remove it from there too: in claude.ai, Customize → Connectors; in Codex, Settings → MCP servers.

​
If something goes wrong

It’s usually one of two things. Either you put a list in ?features= and it replaced the default set, or when reconnecting you left out what you had before. Rebuild the URL with everything together, for example ?features=all&pii=full, and reconnect.
Check in this order:
  1. The group isn’t in your URL, or your URL has read_only=true, which removes all writes. Look for it in the tables above.
  2. You don’t have access to that app, or it’s switched off in your business. Ask it “which business are you working in, and with what permissions?”.
  3. It’s an old chat. Open a new one.
  4. It still doesn’t show up. Delete the connector and connect it again.
Your active business changed after you connected: you switched it in your account menu or accepted an invitation from another business. Go back to that business from your account menu, or disconnect and reconnect the connector to work in the one you have active. → The business the connection works in
First, did you reconnect? Changing the URL requires deleting the connector and adding it again. If you did, check how it’s written. A misspelled group is ignored, and pii=FULL has no effect: it goes in lowercase (read_only does turn on with any value that isn’t a “no”). An incomplete agent= is ignored too. Fix it and reconnect.
The most common cause is that you authorized with another account. Ask it “which DarkFunnels account are you connected to?”. If it isn’t yours, delete the connector, go into the dashboard at optimind.darkfunnels.ai with the right account (sign out of the other session first if needed) and connect it again. When you authorize, the screen says «Autorizas como» (“You are authorizing as”) and your email: check that it’s yours. If the account is the right one, ask it which business it’s working in.
It made too many requests in a row. Wait the time it says: a few seconds if it went over the per-minute cap, or up to an hour if it went over the hourly one. If it’s working in batch, ask it to go in parts.
It resets at midnight, Lima time. If your business needs more, write to us.

Tools reference

Every bridge tool, group by group.

Security

The masked phone number, the log of every call and what it can’t do.

Invite your team

Each person’s permissions and one account in several businesses.

Connect Claude

The step-by-step guide to connecting your assistant.
Last modified on October 19, 2026