connect-apps
Link a user's Slack account or add QM to the company Slack, or connect an administrator-enabled SaaS app with a one-time OAuth consent link.
- License 许可
- MIT
- 所属仓库
- yc-software/qm
- 最近更新
- 2026-11-15
- Stars
- ★ 1.6w
- Forks
- 2.0k
01 前言 Front Matter
- name
- connect-apps
- description
- Link a user's Slack account or add QM to the company Slack, or connect an administrator-enabled SaaS app with a one-time OAuth consent link.
03 SKILL.md 正文
Connecting SaaS apps
Check Composio availability through GET /v1/composio/toolkits on the authenticated QM API. When available, load the composio skill and use its discovery and consent flow instead
of the direct OAuth flow below. An empty direct OAuth list or a native
oauth_not_configured error does not describe Composio availability. Preserve explicit
app restrictions and account permissions; never switch credentials to evade a denial.
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 direct OAuth allowlist is
the providers configured by the admin, the catalog entries with configured: true:
curl -fsS "$AGENT_API_URL/v1/connectors/catalog" -H "x-agent-capability: $AGENT_API_TOKEN" \
| jq -r '.catalog[] | select(.configured) | .provider'
Offer direct OAuth links only for those providers, and none when the 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":"<configured-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 native provider is not configured. Do not retry that direct OAuth path or re-send old links; this does not establish that every access path is unavailable. - 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.
Connect a personal Slack account
When someone asks to connect Slack or use their existing web connectors from Slack, offer the personal Slack linking widget in web chat, or direct them to QM web Settings (/?view=settings) and Link your Slack account from Slack. They must sign in with their existing web account before connecting. This authorizes personal Slack access and links their verified Slack identity to that QM account. Workspace bot installation is separate. Do not create a generic Composio Slack link or infer identity from matching emails.
In web chat, when someone asks to link or connect their Slack, reply with one short line and ::link-slack-account{} as a standalone paragraph, outside code fences and quotations. Do not list other options. It shows the personal linking card and its verified connection status. Company bot installation must be completed first: for an admin whose GET /v1/admin/slack-installation shows configured: false, use ::add-to-slack{} instead. When they ask to add or install QM in their Slack, reply with ::add-to-slack{}. That widget shows whether QM is already installed and includes the linking card, so never pair it with ::link-slack-account{}, and do not describe buttons or name a workspace around it. In Slack, send them to QM web Settings while signed into their existing web account; web widget directives do not render in Slack.
04 同仓库更多 Skills
zoom
Find, create, reschedule, and cancel the user's Zoom meetings through their own Zoom connection.
use-shared-credential
When you need to call a service the org has a SHARED credential for (a SERP/search key, a paid-API key, a data-vendor feed, a Git remote) — and the platform has told you that credential is available to this conversation — make the call BY PROXY through the credential broker. You never see the secret; the core stamps it onto the outbound request for you.
ui-state
See what the person is looking at in the QM web UI right now — the whole page (sidebar, every multiview pane, open dialogs) as raw HTML, the app's state as JSON, optionally the CSS and a screenshot. Use when they ask about something on their screen, want help with the UI, or you need to check what a canvas you wrote actually rendered.
ui-canvas
Draw your own HTML/CSS/JS as a full-window overlay on top of the QM web UI — a dashboard, a form, a visualization, controls that message you back. Write, update, replace, pin or dismiss it. Use when an interactive or visual result beats a chat reply.
taste-skill
Design taste and process for anything a person will look at in a browser — landing page, dashboard, prototype, deck. The default design driver for a browsable artifact, with an anti-slop playbook for the visual language.
slack-drafts
Create Slack message drafts in the user's own composer, as the user, through their per-user Slack OAuth. Drafting only — the user reviews and sends from Slack.