AI Integrations with MCP

AI integrations let you use a compatible assistant to view and manage your Grupos Inteligentes account.

The connection uses MCP (Model Context Protocol). It works as a secure bridge between the assistant and the features you authorize.

What You Can Do

After connecting, you can ask the assistant to:

View your plan, limits, and settings.
Search redirectors and view their settings.
List the groups in a redirector.
View your dashboard summary and performance reports.
Analyze aggregate lead data allowed by your plan.
Create redirectors with safe settings.
Add groups to a redirector.
Remove a group after your explicit confirmation.

Tip: Make direct requests, such as: “Show this redirector’s performance for the last 30 days” or “List the full groups in this redirector.”

How to Connect an Assistant

To use AI integrations, you need an active subscription or to be in your trial period. Otherwise, the AI integrations item is disabled in the menu.

Step 1: Open AI Integrations

Sign in to the Grupos Inteligentes dashboard.
Select AI integrations from the menu.
Click Connect an AI assistant and choose OpenCode or Codex.
Follow Choose, Set up, and Authorize. You can also open View setup on an assistant’s card.

This screen shows the latest setup details for your chosen client.

Claude Code does not appear on this screen yet. Follow the manual setup below.

Step 2: Add Grupos Inteligentes

OpenCode

Add the configuration shown in the dashboard to OpenCode. It will have this format:

{
  "mcp": {
    "grupos-inteligentes": {
      "type": "remote",
      "url": "https://api.gruposinteligentes.com/mcp"
    }
  }
}

Then run the authentication command shown in the dashboard:

opencode mcp auth grupos-inteligentes

Codex

Run the two commands shown in the dashboard:

codex mcp add grupos-inteligentes --url https://api.gruposinteligentes.com/mcp
codex mcp login grupos-inteligentes

Claude Code

Add the remote MCP server from your terminal:

claude mcp add --transport http grupos-inteligentes https://api.gruposinteligentes.com/mcp

Then:

Open Claude Code with the claude command.
Enter /mcp.
Choose grupos-inteligentes.
Start authentication and complete authorization in your browser.

By default, this setup is available only in your current project. Add --scope user to the command to use it across all your projects.

Step 3: Authorize in Your Browser

The AI client will open a page in your browser.
Sign in to your Grupos Inteligentes account if needed.
Review the client name and all requested permissions.
Select Authorize client if you agree.

Return to AI integrations and select Refresh list. The new client will appear under Connected assistants.

Connection Permissions

Before authorizing, you will see what the client can view and change:

Permission	What it allows
View account and plan	View features, limits, and settings.
View redirectors and groups	View redirectors and their groups.
View performance	View clicks, trends, capacity, and aggregate reports.
View lead analytics	View aggregate analytics available on your plan.
Manage redirectors	Create redirectors within your plan limits.
Manage groups	Add groups and remove them only after your confirmation.

The AI client cannot:

Delete redirectors or your account.
Manage billing or payment methods.
Retrieve passwords, tokens, or other secrets.
Access individual lead records.
Display your group invitation links.

Small sets of aggregate lead data are also hidden. This protection reduces the risk of identifying a person.

Check operations without making changes

The whatsapp:read and automations:read permissions allow WhatsApp and automation lookups. Authorization may show these exact names.

Check the stored connection status and the outcome of a specific operation.
On Scale, including the trial, check WhatsApp groups, pending associations, the queue, history, and automatic creation settings.
Check when data was last updated. An unavailable count does not mean zero participants.

For example: “Which groups still need attention?” or “Why is creation waiting for this redirector?”.

These lookups do not run a fresh WhatsApp check or create, edit, import, cancel, or repeat operations. Saved settings do not confirm execution. Being queued, creating the group, and making it available through the link are different steps. If the outcome is unknown, check before repeating creation.

Older connections keep their previously approved access. To include the new lookups, use Revoke access and reconnect the assistant. Refreshing the list alone does not grant new permissions.

How to Use It After Connecting

Open the connected client and write your request in everyday language. For example:

“Show my account summary for the last 30 days.”
“Which redirectors are active?”
“List the full groups in redirector 123.”
“Create a redirector named August Launch with the address august-launch.”
“Add this group to redirector 123: [invitation link].”

To remove a group, provide the exact redirector and group. The assistant must ask for your confirmation before completing the removal.

Tip: Check names and numbers before approving a change. The assistant follows the same limits and rules as your account.

How to Revoke Access

You can disconnect a client at any time:

Open AI integrations in the dashboard.
Find the client under Connected assistants. Use View permissions to check access.
Select Revoke access.
Review the information and confirm.

That client’s access will stop immediately. Your other clients and normal sessions will continue working.

Troubleshooting

The browser did not open

Run your client’s authentication command again.

In Claude Code, enter /mcp and start authentication again. If the browser completes authorization but does not return to Claude Code, copy the full URL shown in the browser and paste it into Claude Code.

The client does not appear as connected

Confirm that you selected Authorize client. Then return to the dashboard and select Refresh list.

The request expired or is unavailable

Start authentication again from the AI client. The request is temporary and can be used only once.

The AI integrations item is disabled

Check that your subscription is active in Settings > Current plan. During the trial, access is also available.

Lead analytics are unavailable

Lead analytics depend on the features included in your plan. Your other authorized features remain available.

Still need help?

Email suporte@gruposinteligentes.com.