> ## Documentation Index
> Fetch the complete documentation index at: https://metorial.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Integrations Overview
> Pre-built provider integrations that you can deploy without writing any code
**What you'll learn:**
* What integrations are available
* Authentication types (OAuth vs API key)
* Licensing and deployment options
**Related resources:**
* [Browsing the Catalog](integrations-browsing-catalog)
* [Create A Portal](/create-portal)
## What Are Integrations?
Integrations are pre-built providers that offer ready-to-use tools for popular services. Instead of building API clients from scratch, you can deploy integrations for services like GitHub, Slack, Google Calendar, Exa, and more.
Each integration exposes tools that your AI models can call directly. For example, the GitHub integration provides tools for creating issues, reviewing pull requests, and managing repositories—all without writing any integration code yourself.
Provider pages now offer two setup paths from **Use Provider**: create an **Integration** for reusable application/session setup, or create a **Magic MCP Server** for a connectable MCP endpoint.
## Licensing
Metorial uses the **FSL (Functional Source License)** - source-available with commercial licensing for production.
**What this means for developers:**
* **Free during development**: Build and test without restrictions
* **Source available**: Audit the code for security and compliance
* **Production requires a license**: Contact us when you're ready to deploy
## Deployment Options
### Cloud SaaS (Recommended)
Start building immediately with Metorial's hosted cloud at [platform.metorial.com](https://platform.metorial.com). No infrastructure setup required—just create an account and deploy integrations.
**Ideal for**: Teams who want to focus on building AI features rather than managing infrastructure.
### Enterprise On-Premises
Self-host Metorial in your own cloud environment when you need full control over data and infrastructure. Metorial uses **HashiStack** (Nomad, Vault, Consul) and deploys to AWS, GCP, Azure, or your private cloud.
**Ideal for**: Enterprises with strict data residency requirements or compliance needs.
Contact us for enterprise licensing and deployment support:
[Book a meeting](https://cal.com/team/metorial/30min) or email us at [hey@metorial.com](mailto:hey@metorial.com)
## Authentication Types
Integrations use two authentication patterns depending on whether they access shared services or user-specific data.
### API Key Integrations
Best for services where one API key serves your entire application. The integration uses your credentials to make requests on behalf of your app.
**Examples**: Exa (search), Tavily (search), Brave (search)
**When to use**: Single-tenant applications, internal tools, or services that don't have user-specific data.
**Setup**: Get an API key from the service, create a deployment in Metorial, and paste your key. Done.
### OAuth Integrations
Required when each user needs to authorize access to their own account. The integration acts on behalf of individual users with their explicit permission.
**Examples**: Slack, GitHub, Google Calendar, Gmail
**When to use**: Multi-tenant applications where users connect their personal accounts.
**How it works**: Users authorize via OAuth, you store their **Provider Auth Config ID**, and pass it when creating sessions. Each user's data stays isolated.
**Managed OAuth credentials cover a subset of integrations.** Metorial provides default OAuth apps for a subset of popular providers (e.g., Slack, GitHub) so you can get started without registering your own. Less common providers in the catalog may require you to bring your own OAuth app via [Enterprise BYO](integrations-enterprise-byo). Check the provider in the [catalog](integrations-browsing-catalog) to confirm.
See [OAuth Integrations](integrations-oauth) for implementation patterns.
## Tool Filters
Integration setup includes tool filters. Tools are grouped as read-only, write, and destructive actions. For providers like GitHub and Linear, review these groups before enabling production access.
## Choosing Integrations
You can mix both authentication types in the same application. For example, use an API key integration for search (Exa) while using OAuth integrations for user-specific services (Slack, GitHub). When creating sessions, pass multiple deployments together—Metorial combines all their tools into a single tool list for your AI model.
**Single-user applications**: API key integrations work well.
**Multi-user applications**: Use OAuth integrations for user-specific access.
**Enterprise**: Consider BYO OAuth apps with dynamic provider deployments.
## Getting Started
Explore available integrations.
Deploy an API key-based integration.
Deploy an OAuth-based integration.