Skip to content

Connectors

Gaby talks to your systems via MCP — every external integration is a subprocess spawned over stdio with the standard initialize + tools/list handshake. First-party connectors ship with Gaby and pass a shared 8-test contract suite (connectors/_contract/).

Available in v0.3

Connector Scope Source
Postgres read connectors/postgres/
Keycloak read connectors/keycloak/
Redis read connectors/redis/
Sentry read connectors/sentry/
Stripe read + simulate-only refund connectors/stripe/
Slack (MCP ticket source) inbound mcp-servers/gaby-mcp-slack/

Coming in v0.4

Intercom, Freshdesk, Zendesk, Help Scout, HubSpot, Linear, GitHub Issues, Discord, Microsoft Teams — see the registry grid on the Connectors page in the app for the full curated list with status.

Contract

Every connector — first-party or community — must pass the 8-test suite in connectors/_contract/test_contract.py:

  1. initialize returns within 2 s.
  2. tools/list returns at least one tool.
  3. Tool descriptions declare a scope=read|write|admin marker.
  4. healthcheck is implemented and returns {ok: bool}.
  5. Re-init within the same process is idempotent.
  6. Stdio frames are clean JSON-RPC (no stray prints to stdout).
  7. Healthcheck never echoes secrets from env vars.
  8. Disconnect closes cleanly within 1 s.

The Python tests parametrise across every entry in the CONNECTORS list; adding a connector is two lines.