docs(iblai-agent-mcp): add connector model, resolution order & in-chat OAuth - #17
Open
mamigot wants to merge 1 commit into
Open
docs(iblai-agent-mcp): add connector model, resolution order & in-chat OAuth#17mamigot wants to merge 1 commit into
mamigot wants to merge 1 commit into
Conversation
… OAuth
Augment the MCP agent skill with conceptual/behavioral coverage from the
ibl.ai /developer MCP docs that was missing or thinner in the skill:
- Connector model: server / connection / connected-service relationship
- auth_type vs auth_scope orthogonality (how vs whose credentials)
- Runtime credential resolution order (user > mentor > tenant > featured > fail)
- In-chat OAuth events for per-user oauth2 connectors
(oauth_required / oauth_connection_resolved / warning / error, poll & timeout)
- is_featured cross-org semantics and automatic OAuth token refresh
Source: docs-content/developer/agents/mcp-authentication/{architecture,
mcp-connections,oauth-connectors,in-chat-mcp-events}.md
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Augments the
iblai-agent-mcpskill (skills/iblai-agent-mcp/SKILL.md) with MCP concepts and runtime behavior that the ibl.ai /developer MCP docs document but the skill was missing or covered only thinly. Additions are conceptual/behavioral only — no existing content was rewritten or reordered, and no new endpoints or request shapes were invented (the skill's ownapi.iblai.appshapes anduser|mentor|tenantscope terms are preserved).What was added (three new sections before
## Notes)auth_type(how:none|token|oauth2) vsauth_scope/scope(whose:user|mentor|tenant) orthogonality, and that onlyoauth2+usertriggers the in-chat prompt. Also documentsis_featured(lets admins in other orgs create their own connections).oauth_required(withauth_url),oauth_connection_resolved,warning(503),error(400); plus the ~10s poll interval and ~300s timeout, and that completing OAuth after a timeout still works.Source
Content is drawn from the ibl.ai
/developerMCP docs:docs-content/developer/agents/mcp-authentication/architecture.mddocs-content/developer/agents/mcp-authentication/mcp-connections.mddocs-content/developer/agents/mcp-authentication/oauth-connectors.mddocs-content/developer/agents/mcp-authentication/in-chat-mcp-events.mdTerminology was mapped to the skill's existing API vocabulary (docs
platform→tenant,agent→mentor) so the skill stays internally consistent.🤖 Generated with Claude Code