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

> ## Agent Instructions
> Agents: start with https://docs.pre.dev/agents.md, which has complete recipes, plan access, polling rules, errors and limits.
> Authenticate with the workspace API key (pdk_…) from Integrations → Built-in, sent as Authorization: Bearer <key>.
> REST API: https://api.pre.dev (OpenAPI: https://docs.pre.dev/api-reference/openapi.json). AI Gateway: https://api.pre.dev/v1, OpenAI-compatible (OpenAPI: https://docs.pre.dev/api-reference/ai-gateway.openapi.json).
> pre.dev MCP server: npx -y @predotdev/mcp setup adds it to every local coding agent with every pre.dev tool plus the user's own Chrome; the hosted server is https://api.pre.dev/mcp. Search these docs over MCP at https://docs.pre.dev/mcp.

# Provider connections

> Connect accounts and select the right workspace default or project account.

Provider connections authorize the agent to use services through your account. Start from **Project setup → Connections** or [workspace Integrations](https://pre.dev/projects/integrations).

## Connect an account

1. Choose the personal or team workspace that should own the connection.
2. Select the provider and complete its authorization flow.
3. Review the connected account label and any requested permissions.
4. In the project, choose that account or inherit the workspace default.

Multiple accounts for one provider can coexist. For example, a workspace can hold two GitHub or Slack accounts, and each project can select the one it needs. A project pin takes precedence over the workspace default.

## Available providers

The connection catalog includes code hosts, project management, communication, documents, design, CRM, scheduling, deployment, and monitoring. Examples include GitHub, GitLab, Bitbucket, Linear, Jira, Slack, Notion, Google Workspace, Microsoft 365, Figma, HubSpot, Vercel, Supabase, and Sentry.

The catalog and granted provider permissions determine available operations. Connecting a service does not start a sync or authorize every possible action automatically; request the work you want the agent to perform.

## Maintain a connection

Use the connection menu to manage the default, label, or account connection. A **needs re-auth** indicator means you should reauthorize it in the web app. If the agent cannot find a repository or workspace, check both the selected account and its provider-side access.

Before disconnecting an account, check which projects pin it or inherit it as their default. Choose a replacement when those projects still need the provider.

In the CLI, `/integrations` shows your personal connected accounts and their status; press `o` to manage them in the browser.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.