Skip to main content
Connect your CircleCI account to let the Canvas Agent check builds and deploys during an investigation.
Connectors work per user and per Honeycomb Team. You connect your own account, and the Canvas Agent uses the connected service as your account. Connecting a connector does not connect it for anyone else on your Honeycomb Team. If you belong to more than one Honeycomb Team, connect your account in each Team. Your tool permissions also apply only to you, in one Honeycomb Team. There are no Team-level connector controls yet.Connectors work through your account, so an automatic investigation has no connector access at all.

​
What the Canvas Agent can do

  • Read pipeline runs, workflows, job logs, artifacts, and test results.
  • Read deploy environments, components, and deployments.
  • Rerun or cancel a workflow.
  • Roll back a deployed component to an earlier version.
Honeycomb reviews each tool in a connector and gives it a default permission. Until you set your own tool permissions, these defaults apply:
  • The Canvas Agent runs reviewed read-only tools without asking.
  • For reviewed write tools and destructive tools, the Canvas Agent asks you to approve each call.
  • The Canvas Agent does not run deprecated tools.
The Canvas Agent runs a tool only when your investigation needs it. To change the defaults, visit Managing tool permissions.

​
Before you connect

The Canvas Agent connects to CircleCI through the hosted CircleCI MCP server. The server has these requirements:
  • Your projects must be on CircleCI Cloud. CircleCI Server is not supported.
  • The Canvas Agent can access only the projects that your CircleCI account can access.
  • A CircleCI connection lasts 90 days. When it expires, reconnect CircleCI.
  • If you belong to more than one Honeycomb Team, you can connect CircleCI in only one of them at a time. When you connect CircleCI in a second Honeycomb Team, CircleCI revokes the connection in the first Team.

​
Connecting CircleCI

  1. Navigate to Canvas > Connectors.
  2. Find CircleCI in the connector list.
  3. Select Connect.
  4. Authorize Honeycomb from the CircleCI authorization page.
After the connection succeeds, the CircleCI connector shows a Connected badge.

​
Turning CircleCI on or off

  1. In a Canvas chat, select the plus (+) button.
  2. Choose Connectors.
  3. Use the toggle beside CircleCI.

​
Disconnecting CircleCI

  1. Navigate to Canvas > Connectors.
  2. Find CircleCI and select Manage.
  3. Select Disconnect.
To learn more, visit Canvas Connectors.