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

# Connect with Microsoft Copilot

> Add the CivicMarketplace AI Connector to Microsoft 365 Copilot

Connect CivicMarketplace to **Microsoft 365 Copilot** so your team can ask about contracts and suppliers from inside Copilot.

<Note>
  Adding an MCP connector to Microsoft 365 Copilot is done through **Copilot Studio** and typically
  requires a Microsoft 365 Copilot license plus permission to build or publish agents in your
  tenant. Check with your Microsoft 365 administrator if you don't have access.
</Note>

The endpoint you'll use:

```
https://mcp.civicmarketplace.com/mcp
```

## Add the connector in Copilot Studio

<Steps>
  <Step title="Open Copilot Studio">
    Go to [copilotstudio.microsoft.com](https://copilotstudio.microsoft.com) and open (or create)
    the agent you want to extend.
  </Step>

  <Step title="Add a tool / MCP server">
    In the agent, go to **Tools → Add a tool → Model Context Protocol** (or **New tool → MCP**), and
    enter the server URL `https://mcp.civicmarketplace.com/mcp`.
  </Step>

  <Step title="Configure OAuth">
    Choose **OAuth** authentication. Copilot Studio uses CivicMarketplace as the identity provider —
    users sign in with their own CivicMarketplace account and approve the requested permissions the
    first time they use the connector.
  </Step>

  <Step title="Publish and test">
    Save and publish the agent. In Copilot, ask the agent something like *"Search CivicMarketplace
    for HVAC contracts."* The first request prompts each user to sign in.
  </Step>
</Steps>

<Tip>
  Each user authenticates as themselves, so results are always scoped to what that person's
  CivicMarketplace account can access — no shared credentials.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The MCP option isn't available in Copilot Studio">
    MCP support and the exact menu names roll out gradually across tenants and may require specific
    licensing. Make sure your tenant has Copilot Studio enabled and you have rights to add tools to
    agents.
  </Accordion>

  <Accordion title="Users aren't prompted to sign in">
    Confirm the tool's authentication is set to OAuth (not "no authentication"). Re-publish the
    agent after changing authentication settings.
  </Accordion>

  <Accordion title="Permission or access errors">
    The connector only returns data a user's CivicMarketplace account can access. If a user expects
    more, their CivicMarketplace access may need to be updated — contact your account manager.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Example prompts" icon="lightbulb" href="/ai-connector/example-prompts">
    See what you can ask once you're connected.
  </Card>

  <Card title="Tools and permissions" icon="shield-check" href="/ai-connector/tools-and-permissions">
    Review the MCP tools and required permissions.
  </Card>
</CardGroup>