The neonloops MCP server
neonloops has an MCP server, so you can drive your workspace from the AI client you already use — Claude, Codex, ChatGPT, Cursor, or any other MCP client — instead of switching over to the browser.
What can I do with it?
Once a client is connected, you can ask it to build a workflow, test it before it goes live, publish it or unpublish it again, check what a run did, approve or reject a step it's waiting on, or read a table — the same things you'd do in the app, from wherever you're already working.
It reads and writes through the same workspace you use in the browser: a workflow it builds is the workflow you see in the app, and a table it reads is the table on your own screen.
The connection on this page is the focused one: a short list of tools a client can load whole, enough to build, test, publish and watch a workflow. Deleting a workflow, cancelling a run and managing projects happen in the app. Members, billing, files, skills, WhatsApp channels and the rest of the workspace are on the full connection, https://app.neonloops.com/api/mcp/full. Add it next to this one with the same sign-in. In Claude Code, for example: claude mcp add --transport http neonloops-full https://app.neonloops.com/api/mcp/full
ChatGPT and Codex use their own connection, with a separate tool for each step of building, testing, publishing, runs, approvals and reading tables, and no full counterpart: everything else stays in the neonloops web app. Every other client, Claude and Cursor included, uses the connection on this page until you add the full one.
How do I connect a client?
Claude
Signs in with your neonloops account — no token to copy.
- In claude.ai or Claude Desktop, open Settings → Connectors.
- Find neonloops in the directory and click Connect.
- Sign in to neonloops when prompted and approve the connection.
- The directory connector gives Claude a focused set of tools: build, test and publish workflows, approve steps, read tables, see runs. For everything neonloops can do, install the neonloops Workflows plugin: it adds its own connection with every tool, so you can remove the one you connected from the directory.
Claude Code
Needs a personal token from your neonloops workspace — or sign in over OAuth instead. Create a token in Settings → Connected agents
- Connect neonloops in claude.ai (Settings → Connectors). Claude Code picks up your claude.ai connectors automatically; run `/mcp` inside Claude Code to check it is listed. That connector is the focused set of tools; for everything neonloops can do, add https://app.neonloops.com/api/mcp/full as well (see the commands below, with that address).
- Not using a claude.ai account? Run `claude mcp add --transport http neonloops https://app.neonloops.com/api/mcp/v1` with no header, then inside Claude Code run `/mcp` and complete the sign-in to neonloops.
- Prefer a token? Run `claude mcp add --transport http neonloops https://app.neonloops.com/api/mcp/v1 --header "Authorization: Bearer <your token>"`, using a token minted from Settings → Connected agents.
claude mcp add --transport http neonloops https://app.neonloops.com/api/mcp/v1 --header "Authorization: Bearer <your token>"Codex
Signs in with your neonloops account — no token to copy.
- With the Codex CLI installed, run `codex mcp add neonloops --url https://app.neonloops.com/api/mcp/openai` in your terminal.
- Run `codex mcp login neonloops`, then sign in to neonloops in the browser and approve the connection.
- Start a new Codex session. If the server does not appear, reconnect or restart Codex to load it.
- Manage billing and enter secret values in the neonloops web app; these actions are not available through this connection.
codex mcp add neonloops --url https://app.neonloops.com/api/mcp/openai
codex mcp login neonloopsChatGPT
Signs in with your neonloops account — no token to copy.
- In ChatGPT, open Settings → Security and login and turn on Developer mode. Availability depends on your account and workspace policy.
- Open Plugins and select the plus button. Enter neonloops as the name, add a description, and paste the MCP server URL under Connection.
- Choose OAuth and, if asked for a registration method, choose Dynamic client registration. Create the connection, sign in to neonloops, and approve access.
- Start a new chat and select the neonloops connection from the tools menu.
- Manage billing and enter secret values in the neonloops web app; these actions are not available through this connection.
https://app.neonloops.com/api/mcp/openaiCursor
Needs a personal token from your neonloops workspace. Create a token in Settings → Connected agents
- Open (or create) `~/.cursor/mcp.json`.
- Add an entry under `mcpServers` with the server URL and an `Authorization` header carrying a token minted from Settings → Connected agents.
- Restart Cursor, or reload MCP servers, to pick up the new entry.
{
"mcpServers": {
"neonloops": {
"url": "https://app.neonloops.com/api/mcp/v1",
"headers": {
"Authorization": "Bearer <your token>"
}
}
}
}Other
Needs a personal token from your neonloops workspace — or sign in over OAuth instead. Create a token in Settings → Connected agents
- Point the client at the MCP server URL using Streamable HTTP transport.
- If the client supports OAuth, let it discover and complete the OAuth 2.1 sign-in automatically.
- Otherwise, set an `Authorization: Bearer <your token>` header using a token minted from Settings → Connected agents.
curl https://app.neonloops.com/api/mcp/v1 -H "Authorization: Bearer <your token>" -H "Content-Type: application/json"Can I add neonloops to Claude as a plugin?
Yes. The neonloops Workflows plugin gives Claude a “Create a neonloops workflow” action: describe the job you want repeated, and Claude sets it up as a draft workflow in your workspace.
In Claude, open Customize → Plugins → Add → Add marketplace. Enter https://github.com/neonloops/plugins, sync the marketplace, then install neonloops Workflows. Open the plugin's Connectors tab and sign in with your neonloops account. The plugin adds its own connection with every neonloops tool, so you don't need a custom connector, and if you already connected neonloops from the directory, you can remove that one.
Plugins are available on Claude Pro, Max, Team and Enterprise plans. On Team and Enterprise, an owner may need to allow it first.
Prefer a file? Download the plugin ZIP and use Add → Upload plugin. An uploaded copy does not update on its own.
Where do I get a token?
Sign in to neonloops and open Settings → Connected agents. Name the agent, choose what it may do, and create the token — it is shown once, so copy it straight into your client.
That token is the only credential a client needs: when a client asks for an API key or a bearer token, this is what goes there. Clients that sign in over OAuth, like Claude, Codex, and ChatGPT, don't need one at all.
What can an agent do — and not do?
A newly connected agent starts with read-only access: it can see your projects, workflows, run history and chat conversations, including what customers wrote in them, plus your tables, skills, memories and files. Anything that changes your workspace, like creating or running a workflow, has to be turned on explicitly with Read & write, and the riskiest permissions — managing members, connected apps, or billing — come only with Full access or when you pick them one at a time.
An action that can't be undone, like deleting something, asks twice: the agent has to show what it's about to do before a second call actually does it.
A token you create is shown once, lasts 7 days or, if you choose, 40, and you can revoke it any time from Settings → Connected agents. Every call an agent makes is logged, so nothing it did is invisible after the fact.
What does neonloops record when an agent connects?
A log of what the agent did: which tool it called, when, and whether it worked. The values it sent aren't in that log, and the records stay with your workspace.
Beyond that, neonloops only receives the tool calls your client sends — not your conversation with it. The privacy policy has the full detail, including how long each record is kept.
Do I need to write code?
No. Connecting a client uses a settings screen or commands copied from this page or Settings → Connected agents. Once it's connected, you talk to it the same way you already talk to that client.
Is there a public API or SDK?
Not a REST API or SDK, no — the MCP server is the public interface today. If you want to script against neonloops directly rather than through an AI client, the MCP server is what's there.
Who do I ask if something doesn't work?
The address to write to is hi@neonloops.com. Tell us which client you're connecting from and what it showed you when it failed — the error your client displays is the most useful thing to paste.