How-to guide
Use Shuffl with Guru
Connect Guru to let Mello answer from your documents, and see what Shuffl does with it.
For HR and IT administrators
Have your agent do thisPaste the prompt into Claude Code, Cursor or another agent. It follows this guide over MCP and asks before it changes anything others will see.Show the promptHide the prompt
Help me with "Use Shuffl with Guru" in my Shuffl workspace. 1. Read the guide: https://shuffl.ai/docs/markdown/guru 2. Add Shuffl's MCP server: https://shuffl.ai/api/mcp Claude Code: claude mcp add --transport http shuffl https://shuffl.ai/api/mcp When the browser opens, choose my workspace and allow the access the guide needs. 3. Work through the steps in order: Answer from Guru. Do what you can over MCP and tell me which steps only I can do in the browser or in Slack. Show me what you will change and who it affects, and wait for my yes before publishing, inviting or sending anything.
On this page
App links open your signed-in workspace. Check the selected workspace before making changes.
What Guru does in Shuffl
If HR answers live in Guru cards, Mello can answer from the verified ones. Shuffl reads only the cards the token can open.
You need to be a Shuffl workspace administrator, with an administrator in Guru for the steps there.
Answer from Guru
- On Knowledge → Connections, choose Connect next to Guru.
- In Guru, create a user token under My settings → API access, or a collection token.
- Enter the user email or collection id and the token into Shuffl. Shuffl checks it with one read before saving.
- Pick verified cards from a collection or a search, or paste a card link; each is read as a draft for review.
- Check the draft’s text, audience and review date, then publish it.
Shuffl reads: Cards. You pick each one, and Shuffl never writes to Guru.
In Shuffl
- Mello answers from what you publish, with a citation, to the audience you set.
- A new version in Guru becomes a draft for HR to review. The old text stops being used once the change is found.
- Disconnecting withdraws every document it brought in. The originals stay where they are.
If it stops working
When a source reads Access lost or Sync needs attention, check that the connected account can still open it in Guru, then choose Check now.
Disconnect and withdraw deletes the stored key and withdraws what it brought in. Drafts, versions and the originals stay.