User GuideConnectors

Connectors

A connector is a connection to a data source. Once added, ApexMCP generates MCP tools from it that your AI agent can call.

Adding a Connector

Go to Connectors → New Connector and select a type.

All credentials you enter are encrypted and stored in a secure vault. They are never returned in API responses.


PostgreSQL

FieldDescription
NameFriendly name, becomes part of the tool name (e.g. query_postgres_mydb)
HostDatabase hostname or IP
PortDefault: 5432
DatabaseDatabase name
UsernameDB user with SELECT access
PasswordStored encrypted, never returned
SSLEnable for production databases

Click Test Connection before saving. ApexMCP will verify connectivity and run schema discovery, enumerating all tables and views the user has SELECT on.

Tools generated: one query_postgres_<name> tool per table/view selected.


MySQL

Same fields as PostgreSQL. Default port 3306.

Tools generated: one query_mysql_<name> tool per table/view selected.


MongoDB

FieldDescription
NameFriendly name
Connection URIFull MongoDB URI, e.g. mongodb+srv://user:pass@cluster.mongodb.net/dbname

Tools generated:

  • mongodb_<name>_find(collection, filter?, projection?, limit?) — find documents
  • mongodb_<name>_aggregate(collection, pipeline) — run an aggregation pipeline

REST API

REST connectors support three authentication modes.

No Auth / API Key Header

FieldDescription
NameFriendly name
Base URLAPI root, e.g. https://api.example.com/v1
Auth typeNone, or API Key (adds a fixed header)
Header namee.g. X-API-Key
Header valueKey value (stored encrypted)

HTTP Basic Auth

FieldDescription
UsernameBasic auth username
PasswordBasic auth password (stored encrypted)

OAuth2 Client Credentials

ApexMCP fetches a token automatically before each tool call and caches it until expiry.

FieldDescription
Token URLOAuth2 token endpoint
Client IDOAuth2 client ID
Client SecretStored encrypted
ScopeSpace-separated scopes (optional)

JWT (HS256 per-request)

ApexMCP mints a short-lived (60s) JWT for each tool call, signed with your secret.

FieldDescription
JWT SecretSigning key (stored encrypted)
Issuer (iss)JWT issuer claim
Audience (aud)JWT audience claim

Tools generated: endpoint-based tools discovered from the API schema, or manually configured.


GraphQL

FieldDescription
NameFriendly name
Endpoint URLGraphQL endpoint, e.g. https://api.example.com/graphql
Auth typeNone, Bearer token, or API key header
Discovery methodintrospection (auto, default) or manual

With introspection, ApexMCP runs schema discovery and registers a <name>_discover_schema tool plus a graphql_<name>_query(query, variables?) tool.

Note: If your GraphQL server redirects (301/302), ApexMCP follows redirects correctly and re-POSTs the request body.


AWS S3 / S3-Compatible

Works with AWS S3, MinIO, Backblaze B2, Cloudflare R2, and any S3-compatible storage.

FieldDescription
NameFriendly name
BucketBucket name
RegionAWS region (e.g. us-east-1)
Endpoint URLCustom endpoint for S3-compatible stores (leave blank for AWS)
Access Key IDAWS/compatible access key
Secret Access KeyStored encrypted

Tools generated:

  • s3_<name>_list_objects(prefix?, limit?) — list objects in the bucket
  • s3_<name>_get_object(key) — retrieve object content (1 MB cap)

Google Cloud Storage

FieldDescription
NameFriendly name
BucketGCS bucket name
Service Account JSONFull service account key JSON (stored encrypted)

Tools generated:

  • gcs_<name>_list_objects(prefix?, limit?) — list objects
  • gcs_<name>_get_object(name) — retrieve object content (1 MB cap)

Google Sheets

FieldDescription
NameFriendly name
Sheet IDThe ID from the Google Sheets URL
API KeyFor public sheets — no OAuth needed
Access TokenFor private sheets — OAuth2 bearer token

Tool generated: google_sheets_<name>_read(range?) — reads sheet data.


Inbound Webhook

Receives events from external systems (e.g. Stripe, GitHub, your own services) and makes them queryable by your agent.

FieldDescription
NameFriendly name — becomes the endpoint slug
SecretHMAC-SHA256 signing secret
Event bufferMax events to retain (default 100, max 10,000)

External systems POST events to:

POST https://gateway.apexmcp.ai/webhooks/inbound/<connector-slug>

The payload must include the signature header for HMAC verification.

Tool generated: webhook_<name>_recent_events(limit?) — returns the most recent N events (default 10, max 100).


External MCP Server

Proxies agent tool calls to your own MCP server. Useful for custom tools you’ve built yourself.

FieldDescription
NameFriendly name
Server URLYour MCP server’s base URL
Auth typeNone, Bearer token, or API key
Token / API KeyStored encrypted

All tools from your external server are namespaced under <connector-slug>_<tool-name> to avoid collisions.


Managing Connectors

From the Connectors list you can:

  • Test — re-run the connection test at any time
  • Edit — update config (credentials can be re-entered but are not shown)
  • Archive — disables the connector and removes its tools from the MCP endpoint. Archiving is reversible.

Archived connectors no longer count toward your plan’s connector limit.