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

# Integrations Overview

> How connections work, the MCP layer, and what gets unlocked when you plug in.

Mesh Pilot does not replace your tools. Shopify stays the source of truth for orders. HubSpot stays the source of truth for deals. Meta stays the source of truth for ad state. We **orchestrate flows across them** and mirror enough state inside the cockpit that you never have to leave to verify what just happened.

## How a connection works

<Steps>
  <Step title="Open Settings → Integrations">
    Pick the platform card for the brand you want to wire up.
  </Step>

  <Step title="Authorize through OAuth">
    Click **Connect**. You're redirected to the platform's own consent screen. Pick the account or store, confirm the scopes Mesh Pilot is requesting, authorize.
  </Step>

  <Step title="Land back in the cockpit">
    The card now shows **Connected**. The relevant agent(s) start pulling data within minutes.
  </Step>
</Steps>

## What we mirror, what we don't

We **mirror** enough state to surface and act:

* Recent campaigns, ad sets, and spend (for ad platforms).
* Recent orders, customers, and product state (for Shopify).
* Pipeline stages and recent deal activity (for HubSpot).
* Recent calls, transcripts, and outcomes (for LiveKit).

We **don't replicate** your full source-of-truth dataset. We don't try to be a parallel Ads Manager or a parallel CRM. If you disconnect a platform, the cockpit's view of it goes empty — but your data stays safe in the source tool. We do not eat your data.

## The MCP layer

Under the hood, agents talk to external platforms through a thin shared client layer. For REST-shaped APIs (Meta, Amazon) the client calls the platform's HTTPS endpoints directly. For richer wrappers (Google Ads' GAQL query language) the client talks to a small MCP server that handles the heavy lifting. Either way, the **per-brand OAuth tokens** you authorize at connection time are what gate every call — agents can only ever act on what your brand has authorized.

Mesh Pilot also exposes its **own** MCP server, so you can drive the cockpit from your AI client (Claude, Cursor, etc.) over the same authorized connections. See [Developers & MCP](/developers/overview).

## What disconnect does

Disconnect a platform from Settings → Integrations and Mesh Pilot revokes its access upstream (where supported), deletes the local OAuth token, and clears the cockpit's mirror of that platform's data for the brand. Your data in the source tool is untouched.

## Supported platforms today

<CardGroup cols={2}>
  <Card title="Shopify" icon="shopping-bag" href="/integrations/shopify" />

  <Card title="Meta Ads" icon="facebook" href="/integrations/meta-ads" />

  <Card title="Amazon Ads" icon="amazon" href="/integrations/amazon-ads" />

  <Card title="Amazon Seller (SP-API)" icon="package" href="/integrations/amazon-seller" />

  <Card title="Google Ads" icon="google" href="/integrations/google-ads" />

  <Card title="TikTok Ads" icon="music" href="/integrations/tiktok-ads" />

  <Card title="LinkedIn" icon="linkedin" href="/integrations/linkedin" />

  <Card title="X (Twitter)" icon="twitter" href="/integrations/x" />

  <Card title="HubSpot" icon="users" href="/integrations/hubspot" />

  <Card title="LiveKit" icon="phone" href="/integrations/livekit" />
</CardGroup>
