Skip to main content

​
Managing Connections

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

​
Setting up a connection

1

Navigate to Toolkits

Open the Toolkits section from the sidebar.
2

Select or create a toolkit

Choose an existing toolkit to configure or create a new one.
3

Configure authentication

Each integration has its own authentication method:
  • Your own credentials (Jira, Confluence, Tempo, SharePoint, Google Drive) — Enter the instance URL and the API token, client secret or service account key the service issues to your organization
  • OAuth (Outlook Mail, Outlook Calendar) — Name the connection, then sign in with Microsoft and approve the access it asks for
  • Custom MCP server — Provide the server’s address and the authentication it expects
Outlook appears in the toolkit catalog only where your Neural Factory deployment has a Microsoft app registration. If you do not see it, ask your administrator or your Neural Factory contact.
4

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.
5

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.

​
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 for more detailed troubleshooting.