quickstart.mdx

title	Quickstart
description	Get started with Harmonica in minutes

Welcome to Harmonica!

This quick guide will help you get started whether you're creating a session or participating in one.

Are you a participant or host?

Learn how to join a session and contribute to discussions. Learn how to create sessions, invite participants, and manage results.

Quick start for participants

You'll receive an invitation link to join a Harmonica session. This may come via email, message, or shared link. Open the link in your browser. You may need to sign in or create an account if you don't have one yet. Once in the session, you can start your guided conversation. Share your thoughts, answer questions, and contribute to the discussion. After the session, you can view summaries and insights generated from all participants' contributions.

Quick start for hosts

Go to [app.harmonica.chat](https://app.harmonica.chat) and sign in to your account. The fastest way to get started is to **pick a template** — browse options like Team Retrospective, Customer Discovery, or Community Feedback. Each template comes with a pre-configured facilitation prompt and session structure.

Alternatively, type your objective into the "What do you want to find out?" field and Harmonica will generate a session for you.

Complete the multi-step form: - **Objective**: What are you trying to achieve? - **Critical to gather**: What information do you need from participants? - **Context**: Background information for the AI facilitator (optional) - **Session name**: A clear name for your session - Review and edit the AI-generated conversational guide — this is the prompt that shapes how the facilitator talks to participants - Configure pre-session questions (name, email, role, etc.) — all fields can be made optional for anonymous participation - Launch your session when ready Share your session using any of these channels: - **Direct link** — copy the unique session URL - **QR code** — generate and share for in-person events - **Telegram** — distribute to a Telegram group via the Harmonica bot - **API / MCP** — programmatically distribute via the REST API or MCP server As participants complete their conversations, Harmonica generates: - **AI summary** with key themes, perspectives, and areas of agreement or tension - **Individual conversation threads** — each participant's full dialogue - **Export to JSON** for further analysis or integration with other tools

Next steps

Detailed guide for participants Detailed guide for hosts Learn about organizing sessions into projects Find answers to common questions Need help? Contact us at [hello@harmonica.chat](mailto:hello@harmonica.chat) or reach out on [Telegram](https://t.me/harmonica_support).