Connect a system

connect_add · Changes data · Markdown

Connects one of the company's systems: its address, its credential (kept encrypted) and the calls it may make.

Free

This tool costs nothing to call.

Connect our Zendesk so you can read tickets and close the ones we moved. Here is the API token.

Your agent callsconnect_addFree

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": "zendesk",
  "base_url": "https://hansenvoss.zendesk.com/api/v2",
  "auth": "bearer",
  "secret": "zd-example-token",
  "allow": [
    "GET /tickets*",
    "PUT /tickets/*"
  ],
  "description": "The old help desk, until the move is done"
}

What comes back

{
  "connection": {
    "name": "zendesk",
    "base_url": "https://hansenvoss.zendesk.com/api/v2",
    "auth": "bearer",
    "header": null,
    "allow": [
      "GET /tickets*",
      "PUT /tickets/*"
    ],
    "description": "The old help desk, until the move is done",
    "created_at": "2026-10-14T08:00:00+00:00",
    "last_used_at": null
  },
  "writes_need_approval": true
}

Use it when

The agent needs to read or change something in a system that has a REST API.

What it does

Connect one of the company's own systems (an ERP, a ticketing tool, any REST API): its https base address, its credential and the calls the agent may make. The credential is kept encrypted and never shown again. A system behind the company's firewall goes through one of its bridges instead: give `bridge` and `system` (connect_list shows the bridges and the systems each serves) in place of base_url and a credential, which the bridge adds inside the network. On accounts with an owner, writes (POST, PUT, PATCH, DELETE) and changing the allowed calls wait for the owner's approval by default, which shows the exact request. Free.

What comes back

connection: its name, base address, kind of auth, allowed calls and description; writes_need_approval, true when POST, PUT, PATCH and DELETE wait for the owner. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`name`Required	string	Lowercase letters, digits and dashes, like "netsuite" or "zendesk". 2 to 40 characters.
`base_url`	string	Up to 500 characters.
`auth`	string	bearer (Authorization: Bearer <secret>), header (the secret in `header`), basic (secret is "user:password") or none. One of: bearer,header,basic,none. Default: bearer.
`header`	string	For auth header, like X-API-Key. Up to 60 characters.
`secret`	string	Up to 4,000 characters.
`allow`Required	array of strings	The calls it may make: a method and a path pattern each, like "GET /v1/customers" or "POST /v1/tickets". matches anything. 1 to 50 items.
`description`	string	Up to 300 characters.
`bridge`	string	For a system behind the firewall: the bridge it goes through. Up to 40 characters.
`system`	string	With bridge: the system's name in the bridge's config, like "sap". Up to 40 characters.

The call

Over MCP, call connect_add on https://api.conecto.chat/mcp/connect. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/connect_add \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"zendesk","base_url":"https://hansenvoss.zendesk.com/api/v2","auth":"bearer","secret":"zd-example-token","allow":["GET /tickets*","PUT /tickets/*"],"description":"The old help desk, until the move is done"}'

When it refuses

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

Code	When	What to do
`invalid_input`400	The name, address, auth or an allowed call is not valid, or the secret is missing.	Fix what the message names.
`conflict`409	A connection with that name exists.	Pick another name, or remove the old one.
`limit_reached`409	The account has 50 connections.	Remove one first.
`not_found`404	The bridge, or the system on it, does not exist.	connect_list shows the account's bridges and the systems each serves.

More Connections tools

All 6 tools

Give this to your agent.

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

Connect a system

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Connections tools

Give this to your agent.