Connect your agent (MCP)
Use Jsonify from ChatGPT, Claude, Copilot, Cursor or any MCP assistant. Read datasets, start runs, and ask Jason for work without leaving the tool you are in.
Jsonify is an MCP server. Connect it to the assistant you already use and that assistant can read your datasets, inspect pipelines and runs, start a run, and hand Jason a brief, all through the same account and the same workspaces you see in the browser.
- Server URL
https://factory.jsonify.com/mcp- Transport
- Streamable HTTP
- Sign-in
- OAuth, with your Jsonify account
- Scope
- The organisations you authorise
- Add the serverone URL, in your assistant
- Sign inyour Jsonify account
- Askin your own words
- Jason worksbuilds, changes, answers
- Read the resultrows come back to the chat
What you can do from an assistant
What it cannot do: run SQL, upload files, change schedules or settings, or edit the pipeline itself. Those stay in Jsonify, or go through Jason as a request.
Connect your client
Every client needs the same two things: the server URL, and a sign-in with your Jsonify account. Pick your client.
ChatGPT
- Turn on Developer mode. Open Settings → Security and login and enable Developer mode.
- Create the connection. Open Plugins and select +. Name it Jsonify, add a short description, and paste
https://factory.jsonify.com/mcp. - Use OAuth. Choose OAuth for authentication, select Create, and sign in to your Jsonify account when asked.
- Enable it in a chat. Start a new chat, select Jsonify from + → More, and describe the dataset you want.
If Developer mode is unavailable, your plan or workspace settings may restrict custom connections.
Claude
Claude.ai and the desktop app:
- Open connectors. Go to Settings → Connectors.
- Add a custom connector. Select + → Add custom connector. Name it Jsonify and paste
https://factory.jsonify.com/mcp. - Connect. Select Add, then Connect, and sign in to Jsonify when asked.
- Enable it in a chat. In a new chat, open + → Connectors and enable Jsonify. Then describe the data you need.
On a Team or Enterprise plan, your workspace owner may need to add the connector first.
Claude Code, in a terminal:
claude mcp add --transport http jsonify https://factory.jsonify.com/mcp
claude mcp login jsonify
The second command opens a browser to sign in. Choose the organisation the assistant should have access to.
Copilot and Teams
Microsoft 365 Copilot reaches Jsonify through an agent built in Copilot Studio.
- Add the tool. Open your agent in Copilot Studio. Go to Tools → Add a tool → New tool → Model Context Protocol.
- Point it at Jsonify. Name it Jsonify, paste
https://factory.jsonify.com/mcp, and configure OAuth 2.0. Create a connection, sign in, and add the tool to your agent. - Publish. Test the agent, then publish it. Open Channels → Teams and Microsoft 365 Copilot, enable Make agent available in Microsoft 365 Copilot, then select Add channel.
- Install in Teams. Choose See agent in Teams → Add. In Microsoft 365 Copilot, type @, select your agent and ask your question.
Requires Copilot Studio access. Your administrator may need to configure OAuth or approve the agent.
Codex
codex mcp add jsonify --url https://factory.jsonify.com/mcp
codex mcp login jsonify
Cursor
In Cursor’s MCP settings, add a new server named Jsonify of type Streamable HTTP with the URL https://factory.jsonify.com/mcp, then complete the sign-in when Cursor opens the browser. The equivalent configuration entry is:
{
"mcpServers": {
"jsonify": { "url": "https://factory.jsonify.com/mcp" }
}
}
Other assistants
In your assistant’s connections settings, add a remote MCP server named Jsonify. Use Streamable HTTP and OAuth, then sign in to Jsonify. The assistant must support remote MCP servers with OAuth; API-key-only clients cannot connect.
The Add integration catalogue in Jsonify has an Assistant connection card that shows these same commands for Claude Code, Codex or another assistant, and a Check connection button that confirms the sign-in worked. It is the quickest way to verify a new connection.
The organisation requirement
An assistant connection is a grant on your account, made through your Jsonify sign-in, for one or more organisations. Three consequences:
Starting from an assistant without an account
If you connect before you have a Jsonify organisation, the flow looks like this:
- Describe what you want in the assistant, as you would to Jason. The assistant starts a preparation and relays Jason’s questions.
- Open the link the assistant gives you. It shows the brief Jason prepared and the free allowance, asks you to accept the terms, creates your organisation, and starts the first build in the browser.
- Reconnect the assistant. Sign in through the connection again so it is authorised for the new organisation. The assistant picks up the same workspace and chat rather than starting another build.
- Review and accept. When the first run has published, look at the dataset. Telling the assistant you are happy marks the workspace live, the same as Open workspace in the browser.
A preparation waits up to 24 hours for you to open the link; after that, start again.
What the assistant can call
Assistants choose tools on their own from your request; you do not name them. This table is for knowing what is possible and for reading the assistant’s activity log.
| Tool | What it lets the assistant do |
|---|---|
get_context |
See who you are, which organisation is authorised, and the workspaces available. Called first in most conversations |
list_pipelines |
List a workspace’s pipelines with their status, active version and schedule |
get_pipeline |
Read one pipeline: what it collects, its parameters, outputs and latest run |
list_datasets |
List a workspace’s datasets with row counts and versions |
get_dataset |
Read one dataset’s worksheets, columns and version history |
query_dataset |
Pull rows from one dataset version, with column selection and equality filters, a page at a time |
get_run |
Read one run: status, timing, and up to twenty published outputs |
run_pipeline |
Start an activated pipeline with a row cap. Repeating the same request does not start a second run |
list_conversations |
Find earlier chats with Jason in a workspace |
request_work |
Send Jason a brief: build a pipeline, change one, diagnose a run, or answer a question. Returns the chat link |
get_conversation |
Read what Jason has said and done in a chat since the last read |
cancel_work |
Stop the request the assistant sent, and only that one |
start_preparation |
For a new user with no organisation: begin a preparation Jason can work on before sign-up |
build_workspace |
After sign-up, recover the workspace and chat the preparation created, so the assistant can keep following it |
accept_workspace |
Mark a newly built workspace as reviewed and live, the same as Open workspace in the browser |
Reads are bounded so a chat never drowns: fifty items per page for lists, one hundred rows and fifty columns per dataset read, twenty filters, and a pinned dataset version so paging is consistent. The assistant pages when it needs more.
run_pipeline starts existing, activated pipelines only, always with a row cap; it does not change parameters or schedules. For anything that changes the pipeline, the assistant uses request_work, and the change goes through Jason’s normal build, review and activation.
Examples
Show me the Live product offers dataset in Market Radar. Which five products had the largest price change since the previous version, and who sells them?
The assistant reads the dataset, pulls the rows it needs, and answers in the chat. Nothing changes in Jsonify.
Run the price promotion tracking pipeline, capped at 200 rows, and tell me when it finishes and how many rows it published.
The assistant starts the run and reads it back when it completes. The run appears on the pipeline’s runs list like any other.
Ask Jason to add a “promotion ends” column to the price promotion tracking pipeline, using the end date shown on each retailer’s offer badge. Let me know if it asks anything.
The assistant sends the brief to Jason and gives you the chat link. If Jason has a question, the assistant relays it and you answer in the same conversation. When the change is reviewed and activated, the assistant tells you the new version.
Chats started from an assistant
Every request an assistant makes through request_work is a real chat in the workspace. It appears in the chat history with the assistant’s name and icon as the source, so a teammate looking at the history can see what was asked from where. You can open it in the browser at any time, add to it, or stop it. Closing the assistant does not stop work already handed to Jason.
Managing connections
Assistant connections are listed at the bottom of the Integrations page, in their own section and under the Assistant connections category filter. Each card shows the assistant’s name, “Connected” or “Access blocked”, and a menu with Connection details and Disconnect.
Connection details shows the facts: the owner (your account), the access (the organisations you authorise, subject to your current membership; not limited to the workspace you have open), the server URL and the client identifier.
Disconnect removes the assistant’s authorisation for your account across all organisations. Tokens it already holds stop working straight away. Chats it started and work Jason already accepted remain; stop active work from its chat if you need to.
An assistant connection carries your whole membership. If you share a computer with someone, disconnect before you hand it over.
Troubleshooting
| What you see | What it means |
|---|---|
The assistant says Jsonify needs setup, or SETUP_REQUIRED |
Your sign-in is valid but not yet tied to an organisation. Finish sign-up in the browser, then reconnect |
| “Assistant connections require a WorkOS sign-in” in the connect dialog | Your session was not signed in through Jsonify’s sign-in. Sign out and back in, then try again |
| Check connection says “No matching connection on the first page yet” | The sign-in in the assistant has not completed. Finish it, then check again |
| Check connection says “Multiple connections found” | More than one assistant with a similar name is connected. Close the dialog and find yours in the list |
| The assistant can read one workspace but not another | The other workspace belongs to an organisation you did not authorise, or are no longer a member of. Reconnect and authorise it |
| “Access blocked” on a connection card | Jsonify has cut the connection off. Press Disconnect to finish removing it |