Connect your Visito business, choose permissions, analyze conversations, and send a controlled test reply from Codex or Claude.
Connect Codex or Claude to Visito to work with your business in natural language. You can read conversations, identify common questions, and perform the operations you authorize.This guide uses a custom remote MCP connection. MCP is the connection that gives your assistant access to Visito tools. A packaged plugin can also include operating instructions, but it is not required for this setup. Visito’s public plugin-store installation is not part of this guide.
Have an active Visito administrator account for the business you want to connect.
Use Codex with remote MCP support, or Claude with access to custom connectors. A managed Claude workspace may require its owner to add the connector first.
For a messaging test, use a contact and channel you are authorized to message. Reading conversations does not require sending permission.
Use this server address in either assistant:
https://platform-api.visitoai.com/m2m/v1/mcp
Sign in on Visito’s website when prompted. Do not paste your Visito password, API key, or OAuth callback URL into an assistant conversation.
Add a remote MCP server named visito with this URL:https://platform-api.visitoai.com/m2m/v1/mcpUse OAuth sign-in and guide me through connecting my Visito business.Open Visito's sign-in page so I can choose my business and permissions.
Codex can help configure the server when its environment allows it. You still complete Visito sign-in and choose the permissions in the browser. If configuration is unavailable from the conversation, use the manual method below.
In the desktop app, open Settings → MCP servers → Add server. Name it visito, choose Streamable HTTP, and paste the server URL above. Save, select Restart when offered, then Authenticate. Complete Visito’s browser consent. These are the controls documented by OpenAI; labels can vary by app version.Alternatively, with the Codex CLI installed, run:
OAuth sign-in normally opens automatically. If authentication is still required, run:
codex mcp login visito
Keep the login command running while you complete the browser flow. After authorizing in Visito, the browser returns to a temporary address on your computer. Wait for Codex to confirm successful authentication, then return to the app and open a new conversation if the tools are not yet available.
codex mcp list
This lists the configured server; the identity test below verifies that it can actually access Visito. See OpenAI’s MCP setup documentation for configuration details.
Help me connect Visito using this remote MCP server:https://platform-api.visitoai.com/m2m/v1/mcpName it Visito. Open the connector setup if you can, or give me themanual steps. Use OAuth sign-in; do not ask for passwords or API keys in chat.
If Visito is already configured, Claude may show a Connect or Reconnect card. A prompt alone does not guarantee installation of a new custom connector. Use the manual setup when needed; a directory result is not proof that Visito has a public store listing.
Open Add connector (the + menu) and choose Add custom connector.
Enter Visito as the name and the server address above as the remote MCP URL.
Choose Continue, then Sign in now.
Under OAuth client, choose Use your own OAuth client. Enter visito-claude-private-test as the client ID and leave the client secret empty.
Choose Add, complete the Visito sign-in and permission steps below, then return to Claude.
Enable Visito from the conversation’s connector controls if it is not already enabled.
The current registered public client ID has the legacy name visito-claude-private-test. It identifies the OAuth application; it is not a password, API key, or access token. Your Visito sign-in, chosen business, and granted permissions determine access. Use this predefined-client option: Claude’s published-identity and automatic-registration options are not currently registered for this integration.
See the Claude setup screens
Add the name and remote MCP URL.
Choose Sign in now and Use your own OAuth client. Leave the secret empty.
Claude Free currently allows one custom connector. If the add option is unavailable, check your plan’s limit and workspace policy before removing an existing connector. See Claude’s custom connector instructions.
The connection opens Visito’s normal sign-in page. Use your registered administrator account, including Google sign-in if that is how you normally access Visito. After login, you return to Connect Visito.
Visito's regular sign-in page. Spanish interface shown; the fields are the same in English.
Check the account and business before continuing. Use Switch account or Switch tenant if needed. Only eligible active businesses where you are an administrator are listed.Each connection belongs to the business selected here. Changing businesses elsewhere in the Visito dashboard does not change the connection’s business. Connect again to authorize a different business.
Every domain starts with No access. Choose only what your assistant needs:
Selection
What it allows
No access
No permissions from that domain.
Read
The available read operations for that domain.
Read & write
All available read and write actions in that domain, including sending, deletion, automation, or execution where listed.
Custom
Only the individual actions you selected under Customize permissions.
Read-only domains offer only No access and Read. Read all, Read & write all, and Clear all apply to the permissions available in the current request. Limited request means the assistant requested only part of a domain; expand Permission details to see exactly what is available.
A narrow test selection: read channels and templates, with custom conversation permissions. Account details are excluded from the capture.
For the examples below, start with these individual permissions in Customize permissions:
Task
Permissions
Analyze conversation topics
View connected channels; Read conversations and messages.
Send a normal reply and check its result
The above, plus Send replies and attachments; Check message delivery.
Inspect approved WhatsApp templates
View WhatsApp templates. This does not grant template sending.
Keep the other domains at No access. Choose Connect when the account, business, and actions are correct. Codex and Claude may separately ask you to approve tool calls; their approval does not add permissions to the Visito connection.
Use Visito to identify the connected account and business. Tell me what theconnection profile actually reports. Do not assume that a profile ID is abusiness ID, and do not infer permissions from the list of discovered tools.Do not change anything.
Then try a bounded conversation analysis:
Using Visito, review the 20 most recent conversations in the connected business.Read up to five recent customer messages per conversation. Follow paginationas needed and count unique conversations. What are the most common topics?Give counts, the number of conversations successfully reviewed, and any gaps.Avoid names, phone numbers, and identifying quotes. Do not send messages orchange any conversation. Describe this as a sample, not all account activity.
Check that the assistant reads messages instead of guessing from conversation titles. If you request a larger period, ask it to preserve the same filters while following nextCursor and check hasMore. A first page is not the entire result set, and new activity can affect a live list.
Use your own test contact. Replace both placeholders below with a verified name and full international phone number; do not run the prompt with placeholders still present.
Find my test contact [CONTACT NAME], phone [INTERNATIONAL PHONE NUMBER],in Visito. Verify the exact conversation and connected channel. If there aremultiple matches, ask me to choose. Check whether a normal reply is allowed.If it is allowed, send exactly one message:"Hello, this is a test of the Visito connection. ✅"Do not create a new conversation, substitute a template, or send a campaign.Keep the current AI pause state unchanged if the reply operation supports it.Use one idempotency key for this logical send, including any safe retry.Check the message receipt and distinguish queued, sent, delivered, and read.If sending is not possible, explain the reason without trying another route.
A reply is a real customer message. Visito replies can temporarily pause its AI depending on the operation’s settings. Inspect the proposed recipient, channel, text, and pause behavior before approving a send.
For WhatsApp, a normal reply depends on the conversation’s messaging eligibility. Outside the permitted reply window, an approved template may be needed. Ask the assistant to inspect the channel’s available templates, language, approval, and required variables first. Template approval alone does not prove the channel is ready to send. Approve the exact template and recipient before sending, and grant template-send permission only if needed.A queued or accepted result is not delivery confirmation. Ask for the receipt status; if the provider has not returned a delivery update, the correct result is delivery pending. Repeating the request with a new idempotency key can create a duplicate message.For a campaign, start by asking for a draft audience and template plan. This connection does not expose a dedicated campaign object; do not assume that a request to “send a campaign” creates a managed campaign in Visito.
Open Developers → API keys & apps. In Spanish: Desarrolladores → Claves API y apps.
Set the access-type filter to Connected applications / Aplicaciones conectadas.
Open View permissions / Ver permisos on your connection to inspect its domains, creator, and activity.
To revoke access, choose Disconnect application / Desconectar aplicación and confirm the intended connection.
The permission drawer includes the disconnect action. This example shows a broader existing grant, not the recommended test permissions.
Disconnecting one grant leaves other connections active. If the disconnect action is unavailable, ask the connection owner or an eligible administrator to review it. To change granted permissions, disconnect and reconnect with the desired selection.Remove the connector from Claude or the MCP configuration from Codex if you also want to remove it from that assistant. For Codex:
codex mcp logout visitocodex mcp remove visito
Revoking Visito access prevents new authenticated operations; it does not erase information already copied into an assistant conversation.
