Nexly Analytics

On this page

MCP (Model Context Protocol) lets AI tools like Claude, Cursor, and Codex securely read your Nexly analytics — traffic, reports, funnels, and property details — directly inside the chat or editor.

Nexly exposes a hosted MCP server. There is nothing to install and no tokens to copy: you connect with OAuth and authorize access with your Nexly account, the same way you would sign in with Google. Access is read-only — connected tools can query analytics but can never change anything in your account.

https://api.nexly.to/mcp

note

The MCP server accepts OAuth connections only. Personal API tokens (nxp_…) are for the read API and do not work with MCP.

Connect Nexly to Claude​

You'll need the Claude Desktop app (or claude.ai) and a Nexly account. The setup takes about two minutes.

Step 1: Open Claude settings​

Open Claude, go to Settings → Connectors, and pick Add → Add custom connector.

Step 2: Add a custom connector​

Fill in two fields:

• Name: Nexly
• URL: https://api.nexly.to/mcp

Leave the OAuth client fields under Advanced settings empty. Click Add.

Step 3: Connect your account​

Nexly now appears in your connectors list. Open it and click Connect. Claude opens the Nexly authorization page in your browser; sign in to Nexly first if you are not signed in already.

Step 4: Authorize Claude in Nexly​

The authorization page shows exactly what Claude will be able to do: read Analytics, Reports, Funnels, and Properties. Review the permissions and click Authorize.

Once authorized, you return to Claude and the connection is active — the connector page lists the available Nexly tools and lets you tune per-tool approval. The same connector works in Claude Desktop, on claude.ai, and in the Claude mobile apps.

Connect Nexly to Cursor​

Cursor connects to remote MCP servers with OAuth as well.

Step 1: Add the server​

Open Customize → MCPs and click New MCP Server (or New).

Cursor opens ~/.cursor/mcp.json; add the Nexly server there:

{

  "mcpServers": {

    "nexly": {

      "url": "https://api.nexly.to/mcp"

    }

  }

}

Step 2: Authenticate​

Back in the MCPs list, Nexly shows up as Needs authentication. Click Authenticate.

Cursor opens the Nexly authorization page in your browser. Review the read-only permissions and click Authorize.

Once connected, the server appears in the list with its tools enabled; open its settings to toggle individual tools.

Connect Nexly to Codex​

Codex connects to remote MCP servers over Streamable HTTP with OAuth. The desktop app, CLI, and IDE extension share one MCP configuration, so adding Nexly once makes it available everywhere.

Step 1: Open MCP settings​

In the Codex app, open Settings → Plugins and switch to the MCPs tab. Click Add server.

Step 2: Add the Nexly server​

On the Connect to a custom MCP screen, fill in:

• Name: Nexly
• Type: Streamable HTTP
• URL: https://api.nexly.to/mcp

Leave the bearer token and header fields empty — Nexly uses OAuth, not tokens. Click Save.

Step 3: Authorize Codex in Nexly​

When Codex first connects to the server, it opens the Nexly authorization page in your browser. Sign in if needed, review the read-only permissions, and click Authorize.

Prefer the terminal? The same server can be added to ~/.codex/config.toml as a [mcp_servers.nexly] table with url = "https://api.nexly.to/mcp", then authorized with codex mcp login nexly — the app and CLI read the same configuration.

Other OAuth-capable MCP clients (for example Grok) connect the same way: give them the server URL and approve access on the Nexly authorization page.

What you can ask​

Once connected, the AI tool can call read-only analytics tools: overview and time-series stats, top pages, sources, countries, devices and browsers, custom events, funnels, reports, anomalies, and AI-traffic breakdowns.

Good examples:

• "How did traffic change on my site over the last 28 days?"
• "Which pages drive the most signups this month?"
• "Summarize the latest weekly report."
• "What is the conversion of the onboarding funnel?"

Manage connected apps​

Every connection you authorize appears in the Nexly dashboard under Settings → Connected apps, with the app name and its last activity.

To revoke access, click Disconnect next to the app and confirm. The app loses access immediately; you can always reconnect later by authorizing again.

Security​

• Authorization uses OAuth 2.1 with PKCE; credentials are never shared with the connected app.
• Access is limited to read-only analytics data available to your account.
• Tokens are short-lived and refreshed automatically; disconnecting an app revokes all of its tokens at once.