> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuralfactory.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Connections

> Set up and maintain toolkit connections and credentials.

# Managing Connections

Toolkit connections require authentication to access external services. This guide covers setting up, testing, and maintaining those connections.

## Setting up a connection

<Steps>
  <Step title="Navigate to Toolkits">
    Open the **Toolkits** section from the sidebar.
  </Step>

  <Step title="Select or create a toolkit">
    Choose an existing toolkit to configure or create a new one.
  </Step>

  <Step title="Configure authentication">
    Each integration has its own authentication method:

    * **OAuth** (Jira, Confluence, Outlook, SharePoint, Google Drive) — Click "Connect" and complete the OAuth authorization flow in the popup window
    * **API key** — Enter the API key provided by the external service
    * **Custom credentials** — Provide the required credentials as specified by the integration
  </Step>

  <Step title="Test the connection">
    After configuring credentials, use the **Test Connection** button (if available) to verify that Neural Factory can successfully communicate with the external service.
  </Step>

  <Step title="Assign to agents">
    Once the toolkit is connected, assign it to the agents that should be able to use it. This is done in the agent configuration under the tools section.
  </Step>
</Steps>

## Managing existing connections

### Refreshing credentials

OAuth tokens may expire over time. If a toolkit stops working:

1. Navigate to the toolkit in the **Toolkits** section
2. Click **Reconnect** or **Re-authorize**
3. Complete the OAuth flow again

### Revoking access

To disconnect a toolkit:

1. Navigate to the toolkit configuration
2. Click **Disconnect** or remove the credentials
3. Remove the toolkit from any agents that had it assigned

### Viewing connection status

The Toolkits page shows the connection status for each configured toolkit — whether it's connected, requires re-authorization, or has errors.

## Troubleshooting

* **OAuth flow fails** — Ensure your browser allows popups for the Neural Factory domain
* **Connection test fails** — Verify that the external service is accessible and the credentials are correct
* **Intermittent failures** — Check if the external service has rate limits or downtime
* **Permission errors** — The authenticated account may lack the required permissions in the external service

See [Connection Problems](/help/troubleshooting/connection-problems) for more detailed troubleshooting.