Connect to the correct endpoint
Connect to the correct endpoint
Confirm that the URL is exactly
https://api-dispatcher.bily.ai/mcp. The client must support remote Streamable HTTP MCP servers.Do not use https://app.bily.ai/mcp, llms.txt, or llms-full.txt as the endpoint. Reload the client after you update its configuration.Open the Bily Connect flow
Open the Bily Connect flow
Confirm that the client supports MCP OAuth discovery, Authorization Code with PKCE
S256, refresh tokens, and the mcp_access scope.The MCP endpoint answers an unauthenticated request with the discovery challenge. Compatible clients follow that challenge automatically.If the client cannot complete the flow, use an access key fallback.Replace a rejected credential (401)
Replace a rejected credential (401)
A
401 means the credential is missing, invalid, expired, or revoked. Reconnect through Bily Connect or replace the fallback key.Do not send a Bily Connect credential and x-api-key together.Reconnect after another sign-in prompt
Reconnect after another sign-in prompt
Reconnect through Bily Connect. Bily rotates refresh credentials for security.Reusing an older refresh credential or losing the latest refresh response can invalidate the connection.Do not paste credentials into the client or keep retrying an older credential.
Correct an out-of-scope request (403)
Correct an out-of-scope request (403)
A
403 means the connection is authenticated, but the requested organization, store, permission, or action is outside its allowed scope.With Bily Connect, confirm that the signed-in user still belongs to the organization that owns the store.With a fallback key, use only the default store and organization recorded when the key was created.If the response requires store scope, select the intended store and create a replacement key under Settings > MCP.Improve an empty search result
Improve an empty search result
Describe the outcome, resource, and intended read or write. Add an accessible
storeUrl when the request depends on connected store operations.Set limit from 1 to 20.Do not guess a helper name when search does not return it.Correct invalid execute code
Correct invalid execute code
Pass a string that contains an async arrow function:Keep the code at or below 20,000 characters. Return JSON-serializable data.
Shorten a timed-out execution
Shorten a timed-out execution
One execution can run for at most 20 seconds. Split broad work into smaller calls. Reduce query ranges or result limits, and return only the fields needed for the next decision.
Review a write before approval
Review a write before approval
Approval is expected for write, spend-affecting, and destructive operations. Review the function, store, proposed changes, planning metadata, and verification step in the client.Bily’s planning metadata does not replace the client approval prompt.
Recover missing result data
Recover missing result data
Use
search again. Review the operation’s preconditions, input schema, verification guidance, and connected-store requirements.Confirm that dates are real calendar dates and the requested store is correct.