In this article, we’ll explore how you can connect your ChatGPT account to Marvin’s MCP server in a few simple steps. We’ve also listed some guidelines to keep in mind while prompting to get the best results from Marvin.
Marvin’s MCP server enables the following tools to:
Surface customer knowledge from Marvin in ChatGPT
Work in Marvin to create new projects, Insight reports, and discussion guides directly from ChatGPT
Read-only Tools | Function |
search | Search customer knowledge in Marvin |
list_projects | List projects |
list_project_files | List files |
list_discussion_guides | List discussion guides |
list_available_skills | List available skills |
get_insight | Access Insight report in Marvin |
get_project_overview | Access project overview |
get_discussion_guide_status | Get discussion guide status |
get_file_content | Show file content |
link_context | Bring over context from Marvin links |
get_file_summary | Access file summaries |
fast_ask_ai | Run Ask AI on Fast mode |
standard_ask_ai | Run Ask AI on Standard mode |
get_ask_ai_status | Check if your Ask AI answer in Fast mode is ready |
get_standard_ask_ai_status | Check if your Ask AI answer in Standard mode is ready |
install_skill | Install skill |
You can also add data from ChatGPT to Marvin to share it with your team, and run studies without leaving the tool.
Write Tools | Function |
create_project | Create a project |
create_insight | Create an Insight report |
update_project_overview | Edit or create a project overview |
generate_discussion_guide | Create a discussion guide |
save_discussion_guide | Save a discussion guide to a project |
update_insight | Edit or publish an Insight report |
confirm_insight_image_upload | Add an image to an Insight report |
import_insight_image | Import Insight image from URL |
get_insight_image_upload | Get Insight image upload URL |
Who can connect to Marvin's MCP Server?
All users on Enterprise plans can individually connect their tools to Marvin.
However, Admins may choose to disable this for their Marvin team. In case you're unable to connect, please contact your team Admin(s).
Admins can manage this from Settings > Developer > Enable MCP
Marvin authorizes the login for each user through OAuth.
How do I add Marvin as an app in ChatGPT?
Once you login to ChatGPT, navigate to Plugins and select Add > Add custom MCP server in the top right corner.
Add a name and description for the Marvin plugin.
Under Connection, paste the Marvin MCP server link as instructed below:
If your Marvin account is on app.heymarvin.com, copy and paste this MCP server URL
https://mcp.heymarvin.com
If your account is on app.eu.heymarvin.com, copy and paste
https://mcp-eu.heymarvin.com
Marvin uses OAuth to authorize your access. You may check these details before you proceed.
To proceed, select the checkbox I understand and want to continue, and click Create.
Now, you must sign in to Marvin to complete the integration.
You’ll see the details of the authorization request on the next page.
Once complete, you’ll see the details listed in the Plugins tab.
That’s it. Your accounts are now connected. Now, let’s explore how to surface insights from Marvin in ChatGPT.
How do I pull insights from Marvin into ChatGPT?
Before you begin your question or prompt, make sure that ChatGPT is using Marvin data to generate an answer. Select + in the search bar, click More and select HeyMarvin.
You’ll see it enabled when you type your prompt.
This is what an answer in ChatGPT will look like.
When you query with Marvin MCP, it will use the Standard mode in Ask AI by default. In Standard mode, explorer agents scan all the data to which you have access to find insights and give an in-depth answer. As it runs iterations to generate the answer, each query may take 2–4 minutes.
If you would like to prioritize speed over depth, prompt the tool to run Ask AI in Fast mode.
Answers in MCP will:
Give more weight to Marvin data from the last 6 months, unless you specify that you want to consider older data.
Use the documents and context added to your team's Organizational Memory in Marvin.
Prioritize data from respondents, unless you specify a focus on data from internal team members.
How do I verify the insights from Marvin?
Responses in ChatGPT will include clickable citations that take you to the exact source in Marvin. You'll see the citations as inline links in the text, like [link to insight] or [link to transcript]. Click to view the file or published report in Marvin to verify and learn more.
How do I work in Marvin from ChatGPT?
Before you can share data, you must grant ChatGPT write access. You must check the box against "Perform actions on your behalf within your permission level" while setting up the Marvin connector.
Once you're connected, you can prompt the write actions directly from ChatGPT.
Let’s consider an example. We looked at the customer knowledge in our repository to predict product design trends for 2027.
First, we surfaced insights from Marvin. The MCP read tools ran a search to identify insights in the relevant project.
We then asked ChatGPT to pull in predictions from experts, reports, agencies, etc., across the internet. Once we’d verified and sorted the data to keep, we prompted ChatGPT to create an Insight report in Marvin.
You’ll need to grant access to the List Projects tool to find your project in Marvin. You can choose between Allow once or Always allow. If you Deny permission, ChatGPT will not be able to access the list of projects through the Marvin MCP connector.
While creating an Insight report, remember to:
Specify the project where you want to add the report
Mention share permissions. To collaborate with team members in Marvin or edit further, create a shared or private draft. To share your work with everyone, publish the report. By default, Marvin will create a private draft if you don’t specify.
Add instructions to visualize data as graphs, quotes, tables, callouts, images, and include citations.
Review the report before you add it to Marvin
You’ll need to grant permission for each tool the first time it is run. A prompt to create the report will trigger the Create Insight tool.
Once the report is ready, the tool will add it to the specified project. You can open the Insight in Marvin by clicking the link in the chat.
You can view, edit, leave comments, and publish the report in Marvin. Or you can update the report from ChatGPT.
Next, we prompted in ChatGPT to create a discussion guide based on the report, so we could interview designers and PMs to ask them about the predicted trends.
It used the Generate Discussion Guide tool to draw up a list of questions.
While creating your discussion guide, remember to:
Add details about the study and the people you intend to interview
Ask the AI to check the project overview to understand the objectives
Pull in additional context from Marvin and external sources
Review and iterate before you finalize the questions
Once you’ve reviewed the discussion guide, add an instruction to save it in Marvin. You can access it from the link in your chat or find it in your project.
Access to data
All permissions and access in Marvin transfer over to ChatGPT. You only see insights and answers based on the research that is shared with you in Marvin. Admins need to manage permissions in Marvin to decide which research should be accessible to everyone and which confidential data to safeguard.
Best practices to write prompts in ChatGPT to pull the right insights from Marvin
We recommend that you specify the following in your prompt:
That you want to use Ask AI tool to surface insights from Marvin.
The projects where you want ChatGPT to scan data
Specific files and file types it should refer to
The format of the answer; you can ask for one-pagers, detailed reports, charts, graphs, customer journeys, and more
The more filters or parameters you add, the easier it will be for ChatGPT to find the right data in Marvin. You could include a time period, recency, file tags, and labels used on Marvin, etc. By default, it will use the Standard mode in Ask AI, wherein explorer agents scan all the data to which you have access to generate an in-depth answer. As the tool runs iterations to generate the answer, each query may take 2–4 minutes.
If you would like to prioritize speed over depth, prompt the tool to run Ask AI in Fast mode.
Answers in MCP will:
Give more weight to Marvin data from the last 6 months, unless you specify that you want to consider older data.
Use the documents and context added to your team's Organizational Memory in Marvin.
Prioritize data from respondents, unless you specify a focus on data from internal team members.
For example, you could ask, “Summarize the last five files from Expert Series webinars?”. Or “List the workflows and jobs mentioned most often by product teams in EU-based companies in the last 6 months.”
If you are searching for specific files, include the word “search” in your prompt. For example, “Search for the 5 most recent sales calls in the Demo folder”.
How do I choose between analysis in Marvin and in ChatGPT?
Choosing whether to conduct your research in Marvin or as an app in ChatGPT depends on the objective of your task.
Use Marvin when you... | Use ChatGPT when you... |
Need to search and tag user feedback by feature, role, or any other filter | Need to turn that feedback into technical docs, FAQs, code samples, or help content |
Need to redact PII and control access in a SOC 2 and HIPAA compliant environment | Need to compare your findings to market trends, competitor positioning, or academic frameworks |
Need to create polished insight reports with video clips, highlight reels, and cited quotes | Need to turn research into a finished deliverables like a memo, strategy doc, PRD, or pitch |
Need insights traced to source with clickable links to the exact point in a transcript, video, or file | Want to stress-test your conclusions for bias before you present |