MCP (Claude Code and Codex)

Connect an AI coding tool such as Claude Code or Codex to Loopfour over MCP, for companies that have MCP switched on in Settings and MCP.

MCP (Model Context Protocol) is a standard way for an AI tool to use another product. When you connect Claude Code or Codex to Loopfour, you can ask the tool in plain words to do Loopfour work, such as "list my workflows" or "run the invoice reminder workflow".

You need:

A Loopfour account in a company that has MCP switched on. See Turn MCP on for your company.
Claude Code or Codex installed on your computer.

Server URL

Every AI tool connects to the same address:

https://mcp.loopfour.ai/mcp

You can also copy it from the Server URL field in Settings > MCP in Loopfour.

Turn MCP on for your company

In Loopfour, open Settings and select MCP.
Turn on Allow MCP access.

Only company owners and admins can change this switch. Other members see whether it is on, plus the setup steps. If MCP is off and you are not an owner or admin, ask one to turn it on.

Loopfour checks the switch on each MCP request. When an owner or admin turns MCP off, the next request from any AI tool connected to that company is refused. Turning it back on lets existing connections work again.

Claude Code

Add the Loopfour server

In a terminal, run:

claude mcp add --transport http --scope user loopfour https://mcp.loopfour.ai/mcp

--scope user makes Loopfour available in every folder where you use Claude Code.

Start Claude Code with claude.
Type /mcp, select loopfour and choose Authenticate.
Your browser opens. Sign in to Loopfour.
If you belong to more than one company, pick the company Claude Code should work in.
Read what Claude Code asks for and select Allow.

Check the connection

Type /mcp again. You see loopfour with the status connected.

Codex

Add the Loopfour server

In a terminal, run:

codex mcp add loopfour --url https://mcp.loopfour.ai/mcp

Or add these lines to ~/.codex/config.toml:

[mcp_servers.loopfour]
url = "https://mcp.loopfour.ai/mcp"

codex mcp login loopfour

Your browser opens. Sign in to Loopfour, pick the company Codex should work in and select Allow.

Check the connection

Run codex mcp list. The loopfour row shows Auth OAuth.

Things to try

Ask your AI tool in plain words:

List my Loopfour workflows.

Show the last failed run and explain why it failed.

Run the workflow "Invoice reminder" and tell me the result.

You sign in with your own Loopfour account through OAuth in your browser. The AI tool does not see your password.
Each connection works in one company: the one you picked at sign-in. To switch, remove the connection and sign in again. In Claude Code, use /mcp and clear the authentication for loopfour. In Codex, run codex mcp logout loopfour, then codex mcp login loopfour.
The AI tool can do only what your account can do in that company. If you leave the company, its next request is refused.
If your sign-in ends, the AI tool asks you to sign in again.

What you can do

Area	Examples	Tools
Workflows	List, explain, create (also from a template), edit, validate, activate, pause, run, compare and roll back versions	`list_workflows`, `get_workflow`, `create_workflow`, `create_workflow_from_template`, `update_workflow`, `configure_step`, `validate_workflow`, `activate_workflow`, `pause_workflow`, `run_workflow`, `diff_workflow_versions`, `rollback_workflow`
Runs	List runs, show a run and its logs, explain a failure, wait for a run, retry, restart or cancel it	`list_runs`, `get_run`, `get_run_logs`, `get_step_output`, `explain_run_failure`, `wait_for_run`, `retry_run`, `restart_run`, `cancel_run`
Tables	List and query tables, add, update or delete rows, import a file	`list_tables`, `query_table_rows`, `aggregate_table`, `append_table_rows`, `update_table_row`, `delete_table_rows`, `import_file_to_table`
Files	List, read, upload, update and delete files	`list_files`, `read_file_content`, `upload_file`, `update_file`, `delete_file`
Dashboards	List and read dashboards, create one, add or change widgets	`list_dashboards`, `get_dashboard`, `create_dashboard`, `add_dashboard_widget`, `update_dashboard_widget`
Connections	List and check connections, start a new one that you finish in Loopfour	`list_connections`, `verify_connection`, `start_connection`
Approvals	List pending approvals and approve or reject them	`list_pending_approvals`, `decide_approval`

The server also offers the prompts build_workflow, debug_run and ingest_file_to_table, and resources such as loopfour://workflows/{id}, loopfour://runs/{id}/logs and loopfour://docs/{topic}, which include the variable reference rules.

Permissions and safety

Confirmation before risky changes. Tools that delete, replace or run something ask you to confirm first. Depending on the AI tool, you see a confirmation form, or the tool must ask you and pass your answer back. A confirmation is tied to you, the company, the tool and its exact arguments, and expires after ten minutes.
Limited permissions. An MCP connection can read and change workflows, runs, tables, files, dashboards and approvals, and start connections. It cannot change company settings, team members, API keys or secrets, manage outbound webhooks, or switch MCP on or off. Reading the audit log needs an extra consent step.
Code and secret steps. MCP cannot add, move or change a code step, or a step that uses {{secrets.KEY}}. The API refuses with 403 MCP_CODE_STEPS_NOT_ALLOWED or MCP_SECRET_STEPS_NOT_ALLOWED. Existing ones can stay in a workflow unchanged, so MCP can still edit other steps and run the workflow. Add or edit those steps in Studio.
Audit trail. Changes made through MCP appear in the audit log, marked with the source mcp.
Kill switch. An owner or admin can turn off Allow MCP access at any time. The next request is refused.

Troubleshooting

What you see	What to do
"MCP access is not enabled for this company." at sign-in or on a request (`MCP_DISABLED`)	Ask an owner or admin of that company to turn on Allow MCP access in Settings > MCP, then sign in again
The AI tool worked before and now each Loopfour request fails	MCP may have been turned off for the company. Check Settings > MCP
The AI tool shows data from the wrong company	You picked another company at sign-in. Remove the connection, sign in again and pick the right company
The AI tool asks you to sign in again	Your sign-in ended. Claude Code: `/mcp`, select `loopfour`, Authenticate. Codex: `codex mcp login loopfour`
`MCP_CODE_STEPS_NOT_ALLOWED` or `MCP_SECRET_STEPS_NOT_ALLOWED`	Make that change in Studio
`claude: command not found` or `codex: command not found`	Install the AI tool, then open a new terminal window

MCP (Claude Code and Codex)

On this page