Startup
Fix the invalid environment variables reported above
Fix the invalid environment variables reported above
https MCP_RESOURCE_URL is reported this way too.Startup says MCP_TRUSTED_PROXIES does not name the proxy
Startup says MCP_TRUSTED_PROXIES does not name the proxy
MCP_RESOURCE_URL is served from 127.0.0.1, so a proxy on the same machine must be in front. Set MCP_TRUSTED_PROXIES=127.0.0.1 and have the proxy set X-Forwarded-For. For local testing without a proxy, use MCP_RESOURCE_URL=http://127.0.0.1:3010/mcp.Startup names an environment variable in a tool file
Startup names an environment variable in a tool file
${DB2i_HOST} and ${DB2i_PORT}. Write the value into the file instead.The sign-in page appears, but you meant to use your identity provider
The sign-in page appears, but you meant to use your identity provider
OAUTH_ISSUER_URL isn’t set, or the server can’t see it. Without it, the server uses IBM i sign-on.Signing in (IBM i sign-on)
The log warns that the Mapepire certificate is not verified
The log warns that the Mapepire certificate is not verified
DB2i_IGNORE_UNAUTHORIZED=true is set, often from .env.example. Remove it and set DB2i_SERVER_CERT_FILE or DB2i_CA_FILE.Every sign-on is refused as holding *ALLOBJ or *SECADM
Every sign-on is refused as holding *ALLOBJ or *SECADM
QSYS2.USER_INFO_BASIC and treats that as privileged. Check that people can query that view for their own profile.Sign-on is not available from your network address
Sign-on is not available from your network address
OAUTH_SIGNON_ALLOWED_CIDRS. The signon_refused log line shows the address the server saw. If it’s your proxy’s address, add the proxy to MCP_TRUSTED_PROXIES.The proxy does not match MCP_TRUSTED_PROXIES
The proxy does not match MCP_TRUSTED_PROXIES
X-Forwarded-For. Add the proxy’s address and make it set X-Forwarded-For.The sign-in form was not sent from this server's own page
The sign-in form was not sent from this server's own page
MCP_RESOURCE_URL doesn’t match the address in the browser, or a proxy rewrites the Origin header. Set MCP_RESOURCE_URL to the URL people see.Sign-on for this user profile is blocked on this server
Sign-on for this user profile is blocked on this server
ibmi-mcp-server --admin "unblock MYUSER". That needs OAUTH_ADMIN_SOCKET; without it, restart the server.invalid_grant right after signing in
invalid_grant right after signing in
signon_source_mismatch in the log. OAUTH_CODE_ADDRESS_BINDING=audit allows it.The client asks people to sign in again after every break
The client asks people to sign in again after every break
OAUTH_IDLE_CLOSE_MINUTES.The client can't connect after the server restarted
The client can't connect after the server restarted
Tokens (identity provider)
Every token is rejected with 401
Every token is rejected with 401
Access token rejected. in the log; reason says why. Common causes: aud isn’t the resource URL (set OAUTH_AUDIENCE), iss differs by a trailing slash, the token isn’t a JWT, or it’s signed with HS256.403 insufficient_scope
403 insufficient_scope
OAUTH_REQUIRED_SCOPES. Grant the scope to the person in your provider.Either mode
403 Forbidden: Host not allowed
403 Forbidden: Host not allowed
MCP_ALLOWED_HOSTS.