> ## Documentation Index
> Fetch the complete documentation index at: https://lightsage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Lightsage MCP in Microsoft Copilot

> Connect Lightsage MCP to Microsoft Copilot Studio agents.

Use this path for Microsoft Copilot Studio agents. Consumer Microsoft Copilot and Google-style answer surfaces are not normal user-configurable MCP clients.

<Warning>
  Copilot Studio MCP access is mediated by Power Platform connector and connection flows. Lightsage MCP does not support OAuth today. Connect directly only if your connector can send the `X-Lightsage-Api-Key` header without exposing the key to end users.
</Warning>

<Steps>
  <Step title="Get your Lightsage API key">
    Open the [Lightsage dashboard](https://app.lightsage.com/settings/api) and copy your API key.

    Use the key only where your Copilot Studio connector setup supports API-key authentication. Do not paste it into shared connector docs, screenshots, or public repositories.
  </Step>

  <Step title="Connect the Lightsage MCP server">
    In Copilot Studio, open your agent and use the MCP onboarding flow to connect an existing MCP server.

    Set the server URL to:

    ```text theme={null}
    https://mcp.lightsage.com/mcp
    ```

    When the connector asks for authentication, use the header name `X-Lightsage-Api-Key` with your Lightsage API key if custom API-key headers are supported. If your tenant requires OAuth or another auth model, it cannot connect directly to the hosted Lightsage MCP endpoint today. Use a private server-side wrapper that injects the Lightsage API key.
  </Step>

  <Step title="Add Lightsage tools to the agent">
    Open the agent's **Tools** page, choose **Add a tool**, select **Model Context Protocol**, and select the Lightsage MCP connector.

    Keep the default tool selection first. After the server is connected, turn off tools the agent does not need.
  </Step>

  <Step title="Verify the agent">
    Publish or test the agent, then run a read-only prompt:

    ```text theme={null}
    Use the Lightsage MCP server to check my Lightsage auth status.
    ```

    If tool calls fail with `401`, confirm the connector is sending `X-Lightsage-Api-Key` on every request.
  </Step>
</Steps>

See the [Copilot Studio MCP overview](https://learn.microsoft.com/en-us/microsoft-copilot-studio/agent-extend-action-mcp) and [add MCP tools to an agent](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-components-to-agent).