Charliehub · by A.N.D.Why

Building block 2 · The basics

Connections

A connection links Charlie to an outside account, like Gmail or Slack. Charlie handles the sign-in and keeps the key safe. Your extension says which connection it wants and uses it.

What you'd use it for

In your manifest

The atlassian extension claims a sign-in Charlie already has. It declares no tools at all.

atlassian / manifest.json
"connections": [
  {
    "name": "atlassian",
    "authType": "oauth2-discovery",
    "transport": "mcp-server"
  }
]

The slack extension declares a new token connection of its own (trimmed).

slack / manifest.json
"connections": [
  {
    "name": "slack",
    "label": "Slack",
    "archetype": "token-static",
    "hosts": ["slack.com"],
    "fields": { "tokenLabel": "User token (xoxp-...)" },
    "verify": {
      "url": "https://slack.com/api/auth.test",
      "method": "POST",
      "identityField": "user"
    }
  }
]

What each part means

FieldWhat it does
nameWhich connection. For a built-in one, one of the names below. For a new one, your own name: lowercase letters, digits and hyphens. Required
authType, transportUsed with a built-in name. Records how that service signs in and how Charlie talks to it.
archetypeUsed for a new connection. token-static for a pasted token, or mcp-discovery for a browser sign-in to a hosted MCP server.
labelThe name you see on the Connections page. Required with archetype.
hoststoken-static only. The web addresses the token may be sent to. "*.example.com" covers subdomains.
fields.tokenLabeltoken-static only. The label on the box where you paste the token.
verifytoken-static, optional. An address Charlie checks a new token against before saving it, and which reply field names the account.
url, scopemcp-discovery only. The server's https address and the access to ask for.

What you can and can't add today

Sign-ins Charlie already knows

Charlie has built-in sign-ins for selfactual, notion, atlassian, gmail and hub. Claiming one by name switches it on for your extension. A saved sign-in alone isn't enough. For a service like Atlassian, its tools only appear while a switched-on extension claims it.

Hosted MCP servers bring their own tools

Atlassian and Notion run their own MCP servers. Once you connect, Charlie offers that server's whole set of tools, so the extension needs no "tools" of its own. Charlie keeps those tools tucked away and finds them by search when a request needs one.

New connections you can declare

With token-static you can add any service that takes a pasted token. You paste it on the Connections page. Your handler calls the service with ctx.connections.slack.fetch(url), and Charlie adds the token itself. Your code never sees it.

With mcp-discovery you can point at another hosted MCP server that supports browser sign-in. No installed extension uses this yet.

What still needs a change to Charlie

Any other kind of sign-in, such as a REST service where you supply your own app's client ID. A built-in name Charlie doesn't know shows as Unsupported on the Connections page.

Things to know

See it in

Every field, in full: reference: connections.