Access to Microsoft Copilot Studio with permission to create a custom connector — typically an Enterprise-tier Microsoft 365 feature.
The Swagger 2.0 version of LuxGov's API specification, not the OpenAPI 3.0 version. Copilot Studio's connector wizard only accepts Swagger 2.0. Contact LuxGov support if you're unsure which file you have.
1. Open the connector wizard
In Copilot Studio, choose Create a custom connector.
Copilot Studio's "Create a custom connector" entry point
2. Import the specification
Import the Swagger 2.0 file. Copilot Studio auto-generates the connector's available actions from it.
The import step, showing the file being selected
Known friction point
Some tool descriptions are long enough that Copilot Studio's own field-length limits can trim or reject them during import. If an action looks incomplete or import errors on a description field, this is the likely cause.
3. Configure authentication
Set authentication to API key, in the header, named X-MCP-Key. Paste in your real key.
Authentication configuration screen — key value must be redacted before publishing
4. Add the connector to an agent
Add your new LuxGov connector as an available action inside a Copilot Studio agent (or the general Microsoft 365 Copilot experience).
5. Ask a real question
Try: "What's the status of [a real project name]?"
A successful Copilot Studio conversation showing a real, grounded answer (optional)