Troubleshoot BridgeAI

BridgeAI is the agent built into MockFlow Bridge. Instead of an assistant app, it calls an AI provider with your own API key: OpenRouter, Azure OpenAI or Amazon Bedrock. Most problems come from a key that Bridge cannot see or a model that is not set. For setup, see Choose the AI behind MockFlow Bridge.

Check the BridgeAI setup

Run this command to see each provider, whether its key is set and which model is in use:

mockflow-bridge bridgeai

"BridgeAI needs an OpenAI-compatible provider key"

Bridge did not find an API key. Set the key for your provider in the same terminal window, then start Bridge there:

On macOS or Linux:

export OPENROUTER_API_KEY="your-key"
mockflow-bridge

A key set with export lasts only until you close that terminal window. If BridgeAI worked yesterday and not today, set the key again, or add the export line to your ~/.zshrc or ~/.bashrc file so every new window has it.

The key is set on Windows, but Bridge does not see it

On Windows, set the key with setx, then close the Command Prompt window and open a new one before you run mockflow-bridge. A window that was open when you ran setx does not see the new key.

setx OPENROUTER_API_KEY "your-key"

Azure OpenAI or Amazon Bedrock is missing a setting

Both providers need a second setting besides the key:

• Azure OpenAI needs AZURE_OPENAI_ENDPOINT, the address of your Azure OpenAI resource. The model is your deployment name; set it with mockflow-bridge bridgeai model followed by the name.

• Amazon Bedrock needs AWS_REGION, for example us-east-1.

If one of them is missing, Bridge names the setting that is not set.

"No model selected"

With OpenRouter, a default model is chosen for you. With other providers, choose one:

mockflow-bridge bridgeai model

Pick a model from the list, or type its name. If Bridge says it could not list models, type the model's id as your provider shows it.

"The model request failed"

Mida shows Sorry, the model request failed followed by the provider's status code when the provider rejected the request. The most common causes:

• 401 or 403: the API key is wrong, expired or has no access to the model. Create a new key with your provider and set it again.

• 402 or 429: your provider account is out of credit or has hit a rate limit. Check your balance and limits with the provider.

• 404: the model name is not available from your provider. Choose another with mockflow-bridge bridgeai model.

BridgeAI usage is billed by your provider on your own account, not by MockFlow.

BridgeAI is set up, but another agent answers

If you also have an assistant app installed, Bridge may be set to use it. Switch to BridgeAI:

mockflow-bridge agent bridgeai

On Basic, Bridge runs on Claude Code only; BridgeAI needs Bridge Pro, included in Plus and Max.