What is Model Context Protocol (MCP)?
Model Context Protocol (MCP) is a powerful feature within Brainvine that allows you to connect your Wolleys (AI assistants) with external tools and services. This enables the assistants to retrieve real-time information, process data, and interact with your favorite apps and platforms such as Google Drive, Gmail, Google Calendar, and more.
Benefits of MCP Integration
Real-time information: Wolleys gain access to current data without you having to share it manually
Safe and private: Sandbox environment ensures secure processing of sensitive data
Expandable functionality: Connect with thousands of services through platforms like Zapier or Pipedream
Personalized experience: Determine which Wolleys get access to specific services
Configuring MCP Servers
Accessing MCP Settings
Log in to Brainvine
Click on the "New Chat" button or go to the home screen
Look for the "MCP Connections" button with the plug icon (🔌) in the top right corner of the screen
Click this button to open the MCP configuration screen
Alternatively, you can also access it through the home screen by clicking on the plug icon in the toolbar when starting a "New Conversation".
Adding MCP Servers
There are two ways to add an MCP server:
Method 1: Direct via URL (SSE)
This method is the fastest and works with external platforms such as Zapier or Pipedream.
Click on "Add New MCP Server"
Select the "SSE URL" tab
Fill in the following details:
Name: Give your server a clear name (e.g., "Google Drive Connector")
Description: Briefly describe what this server does
Server URL (SSE): Paste the SSE URL from your external service
Configure Wolley access (see section "Wolley Access Management" below)
Click on "Add Server"
Method 2: Install in Sandbox
This method is safer but slightly slower, perfect for processing sensitive data.
Click on "Add New MCP Server"
Select the "Install in Sandbox" tab
Fill in the following details:
Name: Give your server a clear name
Description: Briefly describe what this server does
Installation command: Enter the installation command (e.g., npx -y @modelcontextprotocol/server-brave-search)
If needed, add environment variables via the "Add Environment Variables" button
Configure Wolley access
Click on "Add Server"
Using the MCP Library
The library contains ready-to-use integrations that you can install with one click.
In the MCP configuration screen, click on the "Library" button in the bottom right
Browse through the available integrations or use the search bar at the top
Click "Install" on the desired integration
Follow the configuration steps (some integrations require OAuth authentication)
Click "Install" to complete the process
Wolley Access Management
You can determine which Wolleys have access to each MCP server:
When adding or editing an MCP server, scroll to the "Wolley Access" section
Choose one of the following options:
Give access to all Wolleys: All available Wolleys can use the server
Select which Wolleys get access: Choose specifically which Wolleys have access
If you choose the second option, check the desired Wolleys in both sections:
Brainvine Wolleys: The standard assistants (Elliot, Lisa, Antonio, Emma)
Personal Wolleys: Your custom assistants
You can also change the access settings later via the users icon (👥) next to each server in the overview.
Popular MCP Integrations
Google Drive
Connect your Wolleys with Google Drive to:
Search and read documents
Analyze file contents
Extract information from spreadsheets
Click on "Library" in the MCP configuration screen
Search for "Google Drive" and click "Install"
Click "Authenticate" and log in with your Google account
Grant the requested permissions
The integration is automatically completed after authentication
Gmail
Connect your Wolleys with Gmail to:
Read and summarize emails
Create and send drafts
Analyze email history
Follow the same steps as with Google Drive, but search for "Gmail" in the library.
Google Calendar
Connect your Wolleys with Google Calendar to:
View and summarize appointments
Check availability
Schedule new appointments
Follow the same steps as with Google Drive, but search for "Google Calendar" in the library.
Managing Existing MCP Servers
Enabling or Disabling MCP Servers
Go to the MCP configuration screen
Find the server you want to manage
Click the "Enable" or "Disable" button next to the server
Editing MCP Servers
Go to the MCP configuration screen
Find the server you want to edit
Click the "Edit" button next to the server
Adjust the desired settings
Click "Update Server"
Deleting MCP Servers
Go to the MCP configuration screen
Find the server you want to delete
Click the "Delete" button next to the server
Confirm your choice in the dialog box
Checking Active MCP Connections
During a chat, you can see which MCP servers are available for the current Wolley:
Look for the indicator button with the plug icon (🔌) in the toolbar above the chat window
A colored indicator means there are active MCP servers for this Wolley
Click on the indicator to see a list of available servers
Frequently Asked Questions
Q: Can I share an MCP server with multiple Wolleys?
A: Yes, you can give access to all Wolleys or select specific Wolleys in the access settings.
Q: Is my data safe when using MCP integrations?
A: Yes, especially when using the Sandbox method. Your data is processed locally and not permanently stored.
Q: Do I need to be a developer to use MCP?
A: No, the library contains ready-to-use integrations that you can easily install. For advanced applications, you can use services like Pipedream without coding.
Q: How many MCP servers can I add?
A: There is no hard limit, but be mindful of your system's performance with many active servers.
Q: What happens if an MCP server is not available?
A: The Wolley will fall back on its built-in knowledge and other available sources.