Start a Discovery
Browse documentation

Connecting Microsoft Copilot

Preview This capability is in Preview and may not be enabled for your organization yet. About release stages

Add Neuralift as an MCP tool in a Microsoft Copilot Studio agent.

Copilot Studio agents can call Neuralift’s MCP tools, so an agent you build for your team can answer questions from your published segments: personas, segment tactics, actions, and the data dictionary. At the end of this guide, your agent will have Neuralift’s tools available and answer “list my data runs” from live data. Copilot Studio’s MCP onboarding wizard is the recommended path.

Before you begin

  • MCP is enabled for your organization (see the overview); your Neuralift team will confirm your exact endpoint when enabling MCP.
  • You have a Neuralift API key. An organization admin creates these (see roles and permissions).
  • Your organization has at least one published use case.
  • You have a Copilot Studio agent with generative orchestration turned on; Copilot Studio requires it for MCP tools.

Copilot Studio supports the streamable (HTTP) MCP transport, which is what Neuralift’s endpoint uses.

Add Neuralift with the MCP onboarding wizard

  1. In Copilot Studio, open your agent and go to the Tools page.
  2. Select Add a tool, then New tool, then Model Context Protocol. The MCP onboarding wizard opens.
  3. Fill in the server details:
    • Server name: Neuralift
    • Server description: a short, clear sentence such as “Read-only access to Neuralift customer segmentation results: use cases, segments, personas, insights, actions, action plans, segment tactics, and the data dictionary.” The agent’s orchestrator uses this description to decide when to call Neuralift, so make it accurate.
    • Server URL: https://app.neuralift.ai/mcp
  4. Select API key as the authentication type.
  5. For the API key Type, select Header, and enter Authorization as the header name.
  6. Select Create. The Add tool dialog appears.
  7. Select Create a new connection. When prompted for the API key value, enter your full key with the bearer prefix: Bearer nlmcp_xxxxxxxxxxxx.
  8. Select Add to agent.

Note. Neuralift expects the header value in the form Bearer nlmcp_...: the word Bearer, a space, then the key. If the connection fails to authenticate after setup, this prefix is the first thing to check, and support@neuralift.ai can confirm the current recommended Copilot Studio configuration.

Verify the connection

In the agent’s test pane, ask:

List my data runs.

You should now see your organization’s published use cases. Copilot Studio discovers Neuralift’s tools automatically from the server, so all nine tools are available to the agent without further setup.

Troubleshooting

  • The connection fails to authenticate. Check the header name is Authorization and the key value includes the Bearer prefix. Ask your admin to confirm the key is active in Settings → API keys.
  • Requests are rejected with a “forbidden” error. MCP is not yet enabled for your Neuralift organization. Contact your Neuralift team.
  • The agent never calls Neuralift. Confirm generative orchestration is on and sharpen the server description so the orchestrator knows when the tools apply. If your tenant applies data policies to Power Platform connectors, those policies also govern this MCP connection; check with your Power Platform admin.

Next steps