> For the complete documentation index, see [llms.txt](https://docs.toolregistry.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toolregistry.ai/basics/integrations.md).

# Integrations

**Integrations** are the first thing you should set up as these are needed to create any runs. 

Manage them at <https://app.toolregistry.ai/integrations>&#x20;

* **Managed** - We host auth & connector logic; click-to-connect. Just toggle the switch and it will work.&#x20;
* **Custom** - Bring your own OpenAPI spec or register a remote MCP. Define auth and scopes, and keep specs focused on allowed actions.
* When creating runs, specify the integrations by passing `customerIntegrationIds` inside `selectedCustomerIntegrationIds`.&#x20;
  * This deterministically controls which tools are available for the run.
  * Use `["*"]` to allow all active integrations (be cautious in production).