---
title: "Connect an agent"
method: POST
path: "/agent-connections"
tags: ["agent_connection"]
---

# Connect an agent

`POST /agent-connections`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/agent-connections`
- Auth: HTTP bearer

Lets an MCP client such as ChatGPT or Claude act for you in this workspace, with your role. Its outward and legal calls still wait for a person's approval. Called from the consent screen; connecting the same client again updates the connection.

## Request body

- object
  - `client_id` string, required
  - `client_name` string, required
  - `metadata_domain` string, nullable, required
  - `redirect_host` string, nullable, required
  - `scopes` string[], required

## Response `200`

The result.

- object
  - `id` string, required
  - `client_name` string, required
  - `metadata_domain` string, nullable, required
  - `redirect_host` string, nullable, required
  - `scopes` string[], required
  - `person` string, required
  - `mine` boolean, required
  - `last_used_at` string, date-time, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)