Troubleshooting

troubleshooting \<font color="#f3f4f6"> problem \</font> \<font color="#f3f4f6"> cause \</font> \<font color="#f3f4f6"> fix \</font> "repository does not exist" repo name typo or teams not added verify repo name ensure bdg sw agents admin team is added as admin (step 2) onboarding issue closed immediately repo not found check the repo name — enter only the repo name, not the full org/repo path governance validation failed signoff files incomplete open the issue's failure comment — it lists exactly which fields are missing fix in governance/ and open a new issue "branch already exists" release branch already created a release for this week was already cut wait for next week or contact the platform team ci/cd pipeline not running secrets not provisioned complete the onboarding step first (step 4) /approve not working not in required github team only members of the required teams (to, bo, rm) can approve contact the platform team to be added to the appropriate team mcp server unreachable ✗ request failed connection refused incorrect bridge mcp server url or network issues verify the mcp url is correct for your account check vpn connection (for bridge dev mode) url format https // bridge kyndryl com/kaif/v2/mcp/tools authentication failures (401) ✗ authentication failed 401 invalid or expired service api key verify service api key in your env file regenerate the key from bridge platform admin ensure the key has mcp access permissions 403 forbidden "tool not allowed for profile" {"detail" "tool not allowed for profile 'default'", "status code" 403} the tool name you're calling does not exist on the mcp server, or it is not assigned to your deployment profile run python scripts/list mcp tools py to see all available tools verify the exact tool name (e g , servicenow search incidents, not servicenow get ticket) ensure the tool is listed in your deployment registration json under mcp tools 403 forbidden "agent instance not found in default collection" {"detail" "agent instance not found in default collection", "status code" 403} missing x route version v3 header add the header to your request headers\["x route version"] = "v3" missing x instance id header if x instance id is missing or wrong, the mcp call may succeed at the http level but tools will not be routed to your deployment, resulting in 403 or empty results ensure x instance id matches your deployment name exactly headers\["x instance id"] = "inc enrichment deploy v1" # must match deployment registration json → name 422 unprocessable entity — wrong payload format status 422 body {"detail" "request body is not valid json rpc 2 0"} you sent a flat json payload instead of json rpc 2 0 format wrong (flat) {"tool name" "bridge execute query", "arguments" {"query" " "}}