All integrations

How to connect Convex to ChatGPT

Inspect Convex tables, browse documents, and run sandboxed queries from chat without cloning the repo for every data question.

Convex

App backend context for product and eng teams.

Convex stores your application data and functions. Connect a deployment in Faction so chat can list tables, read documents, and run one-off queries with the PAT and deployment admins configure.

Connect once at the org level

Set up Convex a single time instead of asking everyone to paste their own keys into ChatGPT.

Workspace boundaries

Give engineering and other teams the Convex tools they need without one shared bundle for the whole company.

Tool-scoped access

Each workspace URL exposes only the Convex actions admins turn on, not every connector in your org.

Works across AI clients

Use the same workspace URL in ChatGPT, Cursor, ChatGPT, or any MCP client your team prefers.

Step by step

Connect Convex to ChatGPT

Six steps from a fresh organization to chatting with Convex inside ChatGPT.

01

Create your Faction organization

Sign up free and create an organization. This is where admins connect tools once, so teammates never wire up their own integrations.

02

Connect Convex from the catalog

Open the integration catalog in Faction and connect Convex with an API key. Faction stores it once for the whole org.

03

Bundle Convex into a workspace

Create a workspace for the team that needs it, such as engineering, and add Convex. Admins choose exactly which tools are on for that workspace.

04

Copy your workspace MCP URL

Every workspace exposes one MCP URL with only the tools you enabled. Copy it from the workspace settings in Faction.

05

Add the URL to ChatGPT

In ChatGPT, go to Settings, then Connectors and add your Faction workspace URL.

  • In ChatGPT, open Settings and go to Connectors.
  • Add a custom connector and paste your Faction workspace MCP URL.
  • Confirm access. ChatGPT can now use the tools your workspace allows.

06

Start chatting

Ask ChatGPT to use Convex in plain language. Faction handles auth and scopes behind one URL.

  • "List tables in our Convex deployment."
  • "Find the organization record for acme.com."
  • "How many users were created this week?"

Your workspace URL

One link connects your whole team.

Faction gives your team a shared AI workspace that plugs into the tools you already use. Each workspace gets one link (an MCP URL) that includes only the tools your admins turn on. Paste it into ChatGPT once and everyone is connected. No keys to copy, nothing to set up per person.

https://yourcompany.runfaction.com/mcp/your-workspace

What the MCP server can do

  • List tables and schema

    See what data the deployment exposes before querying.

  • Browse documents

    Read records from tables for support and debugging.

  • Run sandboxed queries

    Execute one-off read queries against the connected deployment.

  • Inspect functions

    Understand available backend functions when debugging behavior.

Use cases

  • Support debugging

    Look up a user or org record during a customer ticket.

  • Product metrics

    Count entities or check feature flags stored in Convex for weekly reviews.

  • Engineering handoffs

    Summarize data shape and sample records for teammates joining a project.

FAQs

  • Do I have to set up Convex for every teammate?

    No. An admin connects Convex once at the org level. Teammates just add the workspace URL to ChatGPT and start chatting.

  • How does authentication work?

    API key sign-in. Enter your deployment name and a PAT from npx convex login below — both must be saved here in Faction. A deploy key in .env.local is not used by the hosted gateway.

  • Does this work with ChatGPT?

    Yes. ChatGPT supports remote MCP connectors, so you can point it at any Faction workspace URL and use the tools that workspace allows.

  • Can I control which tools ChatGPT can use?

    Yes. Each workspace exposes only the tools admins turn on, so the URL you share never grants more than intended.

Connect Convex to ChatGPT in minutes.

Create an organization, connect Convex, and bundle it into a workspace your team can use from ChatGPT.

Start free