Quickstart
Turn your Mastra Agents into an agent-native application in 10 minutes.
Start with your coding agent#
Use this prompt to connect your Mastra agent to CopilotKit and verify a working conversation. Your coding agent will follow this guide in your project, or you can work through the manual steps below.
Prerequisites#
Before you begin, you'll need the following:
- An OpenAI API key, or an Anthropic API key if you run the agent on Claude
- Node.js 20+
- Your favorite package manager
Getting started#
Set up CopilotKit Intelligence#
Sign in to managed Intelligence. Managed setup uses a server-side project API key and does not issue COPILOTKIT_LICENSE_TOKEN. You will connect the app after you create it below.
Choose your starting point#
You can either start fresh with our starter template or integrate CopilotKit into your existing Mastra Agent.
🎉 Start chatting!#
Your AI agent is now ready to use! Try asking it some questions:
What tools do you have access to?What do you think about React?Show me some cool things you can do!Troubleshooting
- If you're having connection issues, try using
0.0.0.0or127.0.0.1instead oflocalhost - Make sure your Mastra agent is running on port 4111, and that
MASTRA_BASE_URLpoints at it curl http://127.0.0.1:4111/api/agentsshould list your agent by name- Check that your OpenAI API key is correctly set in the
.envfile
Open Inspector and confirm setup#
On localhost, click the Inspector button in the corner of the app.
- Open Agents, then Agent. Your agent is listed.
- Send a chat message. Open Agents, then AG-UI Events. Events are moving.
- Open Threads. The list is unlocked (Intelligence is on), or locked with Enable Intelligence (Intelligence is off).
More detail: Inspector.
What's next?#
Now that you have your basic agent setup, explore these advanced features: