Agent Skills
› yc-software/qm
› connect-apps
connect-apps
GitHub协助用户通过一次性 OAuth 链接连接已配置的 SaaS 应用。生成并转发授权 URL，指导用户完成浏览器端同意操作，实现第三方应用集成。
Trigger Scenarios
用户请求连接 SaaS 应用
需要获取第三方服务访问权限
Install
npx skills add yc-software/qm --skill connect-apps -g -y
SKILL.md
Frontmatter
{
"name": "connect-apps",
"description": "Connect an administrator-enabled SaaS app for a user with a one-time OAuth consent link."
}
Connecting SaaS apps
When $AGENT_OAUTH_CONSENT_TOKEN is set you can help the user connect a SaaS app via a browser
consent link they tap — you never see or enter their password. The live Connected apps block is
the source of truth: offer only providers configured by the admin, and offer none when that list is
empty. Mint a single-use link for the selected provider, then give the user the full URL to open:
curl -sS -X POST "$AGENT_API_URL/v1/connectors/oauth/consent/mint"
-H "X-Agent-Capability: $AGENT_OAUTH_CONSENT_TOKEN" -H 'content-type: application/json'
-d '{"provider":"
- The response has
connectUrl— give the user THAT exact URL (it is the full public tap-through link). Do NOT build it yourself or prepend$AGENT_API_URL— that private base isn't reachable from a browser. - If mint returns
oauth_not_configured, the admin has not enabled that app. Do not suggest it, retry it, or re-send old links. - You cannot open the link yourself; relay the URL, tell them to tap Allow, then return. After they connect, the app's tools/skills work in your 1:1s with them.
Version History
- 7f2c916 Current 2026-08-02 21:46
