Connect your first provider

Choose a preset

Open Providers in the workspace and select a service. Check that your provider account has API access. Copy a key from the provider's own dashboard, enter it in the connection form and save. Never paste your password or a browser session cookie.

The server stores the key encrypted. The saved connection shows whether a key is present, without displaying it. An empty key field while editing leaves the current key unchanged. Use the explicit remove-key option to delete it.

Fetch and test

Select Fetch models when model discovery is supported. The list reflects what the API returns and may change over time. A public model catalog does not prove your account can use each model.

Test connection sends a small generation request to the chosen model. It may use provider credits. A successful test confirms that request worked; it is not a guarantee of all models or advanced features.

For providers without discovery, enter documented model IDs manually. Advanced capabilities should be enabled only after checking the model's official documentation. Update manual entries when the provider changes its models.

Custom providers

Choose an implemented API format and enter the base URL exactly as documented. Max Harness supports OpenAI-compatible chat, OpenAI Responses, Anthropic Messages and Gemini adapters. Compatibility depends on the endpoint following that format; a similar-looking service name is not enough.

Custom destinations use HTTPS. Private network and loopback destinations are blocked unless an administrator has explicitly allowed that host and port for a local provider. Agent page-reading tools cannot use this exception.

Connection errors

An authentication error usually means the key, account permissions or endpoint is incorrect. A missing model error can indicate an outdated ID or the wrong API format. Rate-limit and credit errors must be resolved in your provider account. If a model rejects an image, tools or a generation setting, disable that feature or choose a suitable model.