MCP section completed

docs/src/pages/docs/mcp.mdx

@@ -24,16 +24,22 @@ import { Callout, Steps } from 'nextra/components'
 Jan now supports the **Model Context Protocol (MCP)**, an open standard designed to allow language models to
 interact with external tools and data sources.
 
-MCP acts as a common interface, standardizing the way an AI model requests to perform an action and how it
+MCPs act as a common interface, standardizing the way an AI model can interact with external tools and data
-receives data from a tool. This enables a model to connect to any MCP-compliant tool without requiring custom integration work.
+sources. This enables a model to connect to any MCP-compliant tool without requiring custom
+integration work. The way this works is via clients and servers. Clients are connected to an AI model and a host
+where a user will describe the task needed to be done. These applications hosting client will want to connect
+to different data sources to accomplish a task, for example, notion, google sheets, or even custom APIs. These
+applications will be connected to a server with prompts, tools, and data sources which will be used to complete
+the task.
 
-This document outlines the benefits, risks, and implementation of MCP within Jan.
+Jan is an MCP host that allws you to download different clients and servers and use them to accomplish a task.
+
+This document outlines the benefits, risks, and implementation of MCPs within Jan.
 
 ## Core Benefits of MCP
 
 Integrating MCP provides a structured way to extend the capabilities of the models you use in Jan. Here are the three
 
-
 * **Standardization:** MCP aims to solve the "M x N" integration problem, where every model (M) needs a
 unique connector for every tool (N). By adapting to a single standard, any compliant model can interface with any compliant tool.
 * **Extensibility:** This allows you to augment your models with new abilities. For instance, an AI can be granted
@@ -64,27 +70,22 @@ affect performance (i.e., the more tools the model and the larger the context of
 you will need to wait for a response). Efficient management of tools and their outputs is important.
 
 
-## Configure and Use MCPs in Jan
+## Configure and Use MCPs within Jan
 
-We have integrated an MCP client into Jan to help users in connecting tools to their workflows.
+To illustrate how MCPs can be used within Jan, we will walk through an example using the [Browser MCP](https://browsermcp.io/).
 
-### 0. Pre Setup
+Before we begin, you will need to enable Jan's MCP functionalitie at `Settings` > `MCP Servers`, and toggle
-
+the `Allow All MCP Tool Permission` switch ON.
-You will need to have `node` and/or `python` installed on your machine. If you don't have them installed, you can
-download them from the official websites:
-- [Node.js](https://nodejs.org/)
-- [Python](https://www.python.org/)
-
-### 1. Initial Setup
-
-Before connecting to a tool, you must first enable Jan's MCP host. Navigate to `Settings` > `MCP Servers` and toggle
-the `Enable MCP Host` switch.
 
 ![Turn on the MCP Host](./_assets/mcp-on.png)
 
-### 2. Adding an MCP Server
+Please note that you will also need to have **NodeJS** and/or **Python** installed on your machine. In case you don't
+have either, you can download them from the official websites at the links below:
+- [Node.js](https://nodejs.org/)
+- [Python](https://www.python.org/)
 
-Once the host is enabled, you can connect Jan to one or more MCP tool servers.
+
+### Browser MCP
 
 - Click on the `+` sign on the upper right-hand corner of the MCP box.
 
@@ -102,44 +103,49 @@ Once the host is enabled, you can connect Jan to one or more MCP tool servers.
 
 ![Server Confirmation](./_assets/mcp-setup-3.png)
 
+- Open your favorite chrome-based browser (e.g., Google Chrome, Brave, Vivaldi, Microsoft Edge, etc...) and navigate to the
+[Browser MCP Extension Page](https://chromewebstore.google.com/detail/browser-mcp-automate-your/bjfgambnhccakkhmkepdoekmckoijdlc).
 
-### 3. Using an MCP Tool in a Chat
+![Browser MCP Extension](./_assets/mcp-setup-6.png)
 
-With a server connected, models that support tool use can now request access to your configured MCP. As of now,
+- Make sure to enable the extension to run on private windows. Since Browser Use will have access to all sites you've
-the best models to use MCP are Claude 4 Sonnet, 4 Opus
+already logged into in your regular browser session, it is best to give it a clean slate to start from.
 
-#### 3.1 Local Models
+![Browser MCP Extension](./_assets/mcp-setup-7.png)
 
-- Start a chat with a model capable of tool use and enable tool calling via the UI.
+- Enable the extension to run on private windows by clicking on it and Connecting to the Browser MCP server.
 
+![Browser MCP Extension](./_assets/mcp-setup-8.png)
 
-#### 3.2 Cloud-based Models
+- Go back to Jan and pick a model with good tool use capabilities, for example, Claude 3.7 and 4 Sonnet, or Claude 4 Opus,
+and make sure to enable tool calling via the UI by going to **Model Providers > Anthropic** and, after you have entered your
+API key, enable tool from the **+** button.
 
-- Go to **Model Providers > Anthropic** and, after you have entered your API key, enable tool
+![Browser MCP Extension](./_assets/mcp-setup-9.png)
-calling via the UI.
 
-![Enable Tool Calling](./_assets/mcp-setup-4.png)
+You can check and see if this was accurate below.
 
-- Open up a new chat with, say, Claude 4 Sonnet, and send a request that requires the model to use the browser.
+![Browser MCP Extension](./_assets/mcp-setup-10.png)
-
-![Start Chatting](./_assets/mcp-setup-5.png)
 
 
 ## Troubleshooting
 
-[This is a place for you to add solutions to common problems. For example:]
+- The MCP server won't connect even though I've already added it to my list of MCP Servers?
-
+  - Make sure you have NodeJS and Python installed
-* **Problem:** The MCP server appears as "Disconnected."
+  - Make sure you typed the commands correctly in the MCP Server form
-    * **Solution:** [Your troubleshooting steps here. e.g., "Verify the server address is correct and that the server is running on your machine. Check for firewall rules that may be blocking the connection..."]
+  - Make sure the model you are using has tools enabled
-* **Problem:** A model is not attempting to use any tools.
+  - Restart Jan
-    * **Solution:** [Your troubleshooting steps here. e.g., "Ensure the model you are using supports tool-use. Not all models have this capability..."]
+- The open source model I picked won't use the MCPs I enabled.
-
+  - Make sure the model you are using has tools enabled
+  - Lots of open source models are not designed to use tools or simply don't work well with them, so you may need to try a different model
+  - The model you have selected might be good at tool calling but it is possible that it does not support images, effectively making it unsuitable for some tools that take screenshots of a website like the Browser MCP
 
 ## Future Potential
 
-This integration is the foundation for creating more capable and context-aware AI assistants within Jan. The long-term
+This integration is the foundation for creating more capable and context-aware AI assistants within Jan. The
-goal is to enable complex workflows that leverage your local environment securely.
+long-term goal is to enable more sophisticated workflows that make use of your local environment securely as
+well as your favorite tools.
 
-For example, an AI could cross-reference information between a local document and a remote API, or use a local script to
+For example, an AI could cross-reference information between a local document and a remote API, or use a
-analyze data and then summarize the findings, all orchestrated through Jan's interface. As the MCP ecosystem grows, so
+local script toanalyze data and then summarize the findings, all orchestrated through Jan's interface. As
-will the potential applications within Jan.
+the MCP ecosystem grows, sowill the potential applications within Jan.