Connect a tool

Before you enable a tool

• Decide which account the agent should reach.
• Review the actions and scopes shown by the integration guide.
• Assume enabled tools can be combined: information read from one tool may inform an action through another.
• Use a dedicated or least-privileged account when practical.

Enable and connect

1. 1
   Open Home → Integrations

   Find the bundled tool by category or name.

2. 2
   Read the connection guide

   Kern shows required keys, OAuth scopes, redirect URLs, and provider-specific setup.

3. 3
   Configure secrets

   Enter API keys or OAuth client credentials in the admin UI. They are stored outside the agent workspace.

4. 4
   Enable the tool

   Enabled state is checked on every action; hidden credentials never become part of the tool schema.

5. 5
   Connect an account

   For OAuth tools, finish the provider flow and confirm the account label shown by Kern.

6. 6
   Run a narrow first call

   Ask the agent to list or read a small item, then inspect Tool audit.

Multiple connected accounts

Each OAuth connection has a stable connection id. When more than one account is connected, the agent must choose the intended connection for the action. Use clear account labels so that choice is reviewable.