Connect an MCP client

Floral Agent must be enabled for the workspace before an MCP connection can use it. A workspace administrator controls that setting under Settings > Assistants > MCP. If your settings menu shows Floral Agent instead of Assistants, open Settings > Floral Agent. Every client uses the same server address:

https://app.floral.so/mcp

The Settings > Assistants > MCP page in Floral shows the same steps with the address of your deployment filled in.

Connect with OAuth

Use OAuth when your MCP client supports remote server sign-in. Floral asks you to sign in and choose an eligible organization and workspace, then shows the read and write disclosure. The connection receives the same available tools as the in-app Assistant, subject to your current permissions.

Claude Code
Claude desktop and claude.ai
ChatGPT
Cursor
Microsoft Copilot

Add the server

Run this in your terminal:

claude mcp add --transport http --scope user floral https://app.floral.so/mcp

Approve access

Approve access in the browser window Claude opens. Floral is then available in every Claude Code session on this machine.

Add the server

Add this to your MCP configuration:

{
  "mcpServers": {
    "floral": {
      "url": "https://app.floral.so/mcp"
    }
  }
}

Approve access

Approve access when Cursor opens the Floral sign-in. Cursor can also send a personal access token in the Authorization header instead.

Floral connects to Microsoft 365 Copilot through a Copilot Studio agent. Copilot Studio supports the Streamable HTTP transport that Floral uses.

Add a Model Context Protocol tool

In Copilot Studio, open the agent’s Tools page, choose Add a tool, then New tool, then Model Context Protocol.

Describe the server

Enter a server name and a short description, then paste the server address as the Server URL. The agent uses the description to decide when to call Floral.

Choose OAuth 2.0

Select OAuth 2.0 with Dynamic discovery. Floral publishes the discovery metadata Copilot Studio needs and registers the client automatically.

Create the connection

Select Create, then Create a new connection. Sign in to Floral, choose the workspace, and approve access. Finish with Add to agent.

Publish the agent

Publish the agent to make Floral available in Microsoft 365 Copilot for the people you share it with.

If the MCP onboarding wizard or OAuth 2.0 is not available in your tenant yet, choose API key with type Header, name the header Authorization, and enter a personal access token as Bearer floral_pat_... when you create the connection.

After you connect, the connection appears under Settings > Assistants > MCP, where you can disconnect it. If the client cannot start or complete the sign-in flow, use a personal access token if it supports custom headers, or contact Floral. OAuth connections created before write access was introduced remain read-only. Reconnect the client to review and grant read and write access.

Connect with a personal access token

Open MCP settings

In the target workspace, open Settings > Assistants > MCP, or Settings > Floral Agent > MCP if your menu shows Floral Agent, and select New key.

Choose access

Give the key a recognizable name, select the smallest required scopes, and choose 30 days, 90 days, one year, or no expiry.

Copy the key

Copy it when Floral displays it. The full value is shown once.

Configure the client

Use the MCP server URL and send the key as a bearer token:

Authorization: Bearer floral_pat_...

Client configuration formats differ. Use the client’s current documentation to set a custom header. Revoke the key in Floral when the client is retired or the key may have been exposed.

Start here

MCP

Public API

API guides

Connect an MCP client

Connect with OAuth

Connect with a personal access token

​Connect with OAuth

​Connect with a personal access token

Connect with OAuth

Connect with a personal access token