conecto. Get started
Account admin

Make a bridge to a system behind the firewall

admin_make_bridge · Changes data · Markdown

A new bridge for systems behind the company's firewall, with its token (shown once) and the steps for IT.

$0.001 a call

From your agent’s balance. A call that fails costs nothing.

An example

Our SAP only works inside the office network. Set up what IT needs so you can read orders from it.

Your agent callsadmin_make_bridge$0.001 a call

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "name": "office-hamburg"
}
What comes back
{
  "bridge": {
    "name": "office-hamburg",
    "online": false,
    "version": null,
    "last_seen_at": null,
    "systems": [],
    "token_last4": "qBKg",
    "created_at": "2026-10-14T08:00:00+00:00",
    "revoked": false
  },
  "token": "conecto_br_wzkEERB5PI1aJPNowEjZcE60cNXA9V3cDpblJSbqBKg",
  "program": {
    "url": "https://api.conecto.chat/bridge/conecto_bridge.py",
    "sha256": "8bee8c0a44f3e789fb801a33caeb26c000b5676e0e7ad917c5e0c20f9669f388"
  },
  "config_example": {
    "systems": {
      "erp": {
        "base_url": "https://erp.internal.example:8443/api",
        "headers": {
          "Authorization": "${ERP_AUTH}"
        },
        "allow": [
          "GET /orders*"
        ]
      }
    }
  },
  "steps_for_it": [
    "Download the program from https://api.conecto.chat/bridge/conecto_bridge.py and check its SHA-256: 8bee8c0a44f3e789fb801a33caeb26c000b5676e0e7ad917c5e0c20f9669f388.",
    "On a machine that reaches the system and https://api.conecto.chat, set CONECTO_BRIDGE_TOKEN to the token, and the variables the config's headers name."
  ]
}

Use it when

A system the agent should reach is only on the company's own network, like an ERP or an internal API.

  • For a system with a public https address, use connect_add.

What it does

A new bridge for systems inside the company's network, like an ERP or an internal API. Its token comes back once, with the program for IT to run and the steps. The bridge connects out to Conecto, so nothing opens inbound, and makes only the calls its own config allows. Then connect_add with bridge and system reaches a system through it.

What comes back

bridge, token (shown once), program (download address and SHA-256), config_example and steps_for_it. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
nameRequiredstringLowercase letters, digits and dashes, like office-hamburg. 2 to 40 characters.

The call

Over MCP, call admin_make_bridge on https://api.conecto.chat/mcp/admin. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/admin_make_bridge \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"office-hamburg"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_input400The name is not 2 to 40 lowercase letters, digits and dashes.Use a name like office-hamburg.
conflict409A bridge with that name runs already.Pick another name, or stop the old one.
limit_reached409The account has 10 bridges.Stop one it no longer runs.
owner_required403The key is not one that runs the account: it works for one team, has limits, or is a member's assistant.Use a key of the company-wide team without limits, or ask the owner (account_owner_link).

More Account admin tools

All 15 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md