TAI42 — the OS for AI tools

Manage connector providers and connections.

$ tai connectors [OPTIONS] COMMAND [ARGS]...

`tai connectors add-server`

Add an MCP server that signs in with OAuth as a connector provider. Example: tai connectors add-server https://mcp.example.com/mcp --name "Team tools"

$ tai connectors add-server [OPTIONS] {url}

Argument	Description
`url`	The address of the MCP server to add. (required)

Option	Description
`--id` `<str>`	The provider id (default: suggested from the host).
`--name` `<str>`	The display name.
`--description` `<str>`	A description.
`--icon-url` `<str>`	An https URL of an icon.
`--category` `<str>`	The catalog category (default: other).
`--scope` `<str>`	A scope to request (repeatable; default: what the server lists).
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors connect`

Start a connection flow; prints the authorize URL (or the created connection). Example: tai connectors connect google --alias work --sub-service gmail

$ tai connectors connect [OPTIONS] {provider}

Argument	Description
`provider`	Provider id. (required)

Option	Description
`--alias` `<str>`	A unique alias for the new connection. (required)
`--sub-service` `<str>`	An enabled sub-service (repeatable). (required)
`--config` `<str>`	Provider config values as a JSON object.
`--config-file` `<str>`	Read the provider config values from a file, or from stdin when the path is ’-’, which keeps provider secrets off the command line (a value on argv leaks via ps and shell history). Mutually exclusive with —config.
`--return-url` `<str>`	Where to return after the flow completes (omitted: the deployment’s connectors page).
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors connections`

List the installed connections (no secrets). Example: tai connectors connections

$ tai connectors connections [OPTIONS]

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors disconnect`

Disconnect (delete) a connection. Example: tai connectors disconnect conn_123

$ tai connectors disconnect [OPTIONS] {connection_id}

Argument	Description
`connection_id`	Connection id. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors discover`

Look up an MCP server’s sign-in: every sign-in service it lists and the redirect URI to register. Example: tai connectors discover https://mcp.example.com/mcp

$ tai connectors discover [OPTIONS] [url]

Argument	Description
`url`	The address of the MCP server to look up. (optional)

Option	Description
`--provider` `<str>`	Look up the server of this discovered provider instead.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors get`

Get one connection. Example: tai connectors get conn_123

$ tai connectors get [OPTIONS] {connection_id}

Argument	Description
`connection_id`	Connection id. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors providers`

List the available connector providers. Example: tai connectors providers

$ tai connectors providers [OPTIONS]

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors reconnect`

Start a reconnect (re-authorize) flow for an existing connection. Example: tai connectors reconnect conn_123 --sub-service gmail

$ tai connectors reconnect [OPTIONS] {connection_id}

Argument	Description
`connection_id`	Connection id. (required)

Option	Description
`--sub-service` `<str>`	An enabled sub-service (repeatable). (required)
`--return-url` `<str>`	Where to return after the flow completes (omitted: the deployment’s connectors page).
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors reencrypt-tokens`

Re-encrypt every stored token and client credential under the current CONNECTORS_KEK. Run after rotating CONNECTORS_KEK (old key moved to CONNECTORS_KEK_PREVIOUS) to converge every connection token blob and every stored OAuth client blob onto the new key so the previous key can be retired. Example: tai connectors reencrypt-tokens

$ tai connectors reencrypt-tokens [OPTIONS]

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors remove-server`

Remove a provider added by its address, and its stored client credentials. Example: tai connectors remove-server mcp_example_com

$ tai connectors remove-server [OPTIONS] {provider_id}

Argument	Description
`provider_id`	Provider id. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors set-client`

Set the client credentials of an app registered by hand for a discovered provider. Example: tai connectors set-client mcp_example_com --client-id app --client-secret-file - --issuer URL

$ tai connectors set-client [OPTIONS] {provider_id}

Argument	Description
`provider_id`	Provider id. (required)

Option	Description
`--client-id` `<str>`	The client id of the app registered by hand. (required)
`--client-secret-file` `<str>`	Read the client secret from a file, or from stdin when the path is ’-’ (never an argument: a value on argv leaks via ps and shell history). Leave out for an app without a secret.
`--auth-method` `<str>`	client_secret_post, client_secret_basic or none (default: chosen from the sign-in service).
`--issuer` `<str>`	The sign-in service the app belongs to; the secret is sent to no other.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai connectors sub-services`

Change a connection’s enabled sub-services. Example: tai connectors sub-services conn_123 --sub-service gmail --sub-service calendar

$ tai connectors sub-services [OPTIONS] {connection_id}

Argument	Description
`connection_id`	Connection id. (required)

Option	Description
`--sub-service` `<str>`	The desired enabled sub-service (repeatable). (required)
`--return-url` `<str>`	Where to return if consent is required (omitted: the deployment’s connectors page).
`--json` / `--no-json`	Emit raw JSON instead of human tables.

HTTP API

CLI

Settings

Capability map

Conversation bridge

Python SDK

Studio SDK

tai connectors

`tai connectors add-server`

`tai connectors connect`

`tai connectors connections`

`tai connectors disconnect`

`tai connectors discover`

`tai connectors get`

`tai connectors providers`

`tai connectors reconnect`

`tai connectors reencrypt-tokens`

`tai connectors remove-server`

`tai connectors set-client`

`tai connectors sub-services`

​tai connectors add-server

​tai connectors connect

​tai connectors connections

​tai connectors disconnect

​tai connectors discover

​tai connectors get

​tai connectors providers

​tai connectors reconnect

​tai connectors reencrypt-tokens

​tai connectors remove-server

​tai connectors set-client

​tai connectors sub-services

`tai connectors add-server`

`tai connectors connect`

`tai connectors connections`

`tai connectors disconnect`

`tai connectors discover`

`tai connectors get`

`tai connectors providers`

`tai connectors reconnect`

`tai connectors reencrypt-tokens`

`tai connectors remove-server`

`tai connectors set-client`

`tai connectors sub-services`