docs: remove SSE transport and rename to Streamable HTTP (#6319)
Signed-off-by: Adrian Cole <adrian@tetrate.io>
This commit is contained in:
@@ -70,13 +70,13 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on
|
||||
apiKeyLinkText="Service Access Token"
|
||||
/>
|
||||
|
||||
<!-- For external SSE or HTTP MCP servers -->
|
||||
<!-- For HTTP MCP servers -->
|
||||
<GooseDesktopInstaller
|
||||
extensionId="{extension_id}"
|
||||
extensionName="{Extension Name}"
|
||||
description="{Extension description}"
|
||||
type="sse" // or "http"
|
||||
url="https://example-server.com/endpoint"
|
||||
type="http"
|
||||
url="https://example-server.com/mcp"
|
||||
envVars={[ // also used for http request headers
|
||||
{ name: "SOME_KEY", label: "Description or placeholder value" }
|
||||
]}
|
||||
@@ -107,12 +107,12 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on
|
||||
}
|
||||
/>
|
||||
|
||||
<!-- For external SSE or HTTP MCP servers -->
|
||||
<!-- For HTTP MCP servers -->
|
||||
<CLIExtensionInstructions
|
||||
name="{Extension Name}"
|
||||
description="{Extension description}"
|
||||
type="sse" // or "http"
|
||||
url="https://example-server.com/endpoint"
|
||||
type="http"
|
||||
url="https://example-server.com/mcp"
|
||||
timeout={300}
|
||||
envVars={[ // also used for http request headers
|
||||
{ key: "API_KEY", value: "▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪" }
|
||||
|
||||
@@ -69,9 +69,8 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
|
||||
│ ○ Built-in Extension
|
||||
// highlight-start
|
||||
│ ● Command-line Extension (Run a local command or script)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (SSE)
|
||||
│ ○ Remote Extension (Streaming HTTP)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (Streamable HTTP)
|
||||
└
|
||||
```
|
||||
|
||||
|
||||
@@ -15,12 +15,12 @@ Cloudflare provides multiple specialized MCP servers for different aspects of th
|
||||
|
||||
<Tabs groupId="interface">
|
||||
<TabItem value="ui" label="goose Desktop" default>
|
||||
[Launch the installer](goose://extension?cmd=npx&arg=mcp-remote&arg=https%3A%2F%2Fobservability.mcp.cloudflare.com%2Fsse&id=cloudflare-observability&name=Cloudflare%20Observability&description=Debug%20and%20get%20insight%20into%20your%20application%27s%20logs%20and%20analytics&env=CLOUDFLARE_API_TOKEN%3DCloudflare%20API%20Token)
|
||||
[Launch the installer](goose://extension?cmd=npx&arg=mcp-remote&arg=https%3A%2F%2Fobservability.mcp.cloudflare.com%2Fmcp&id=cloudflare-observability&name=Cloudflare%20Observability&description=Debug%20and%20get%20insight%20into%20your%20application%27s%20logs%20and%20analytics&env=CLOUDFLARE_API_TOKEN%3DCloudflare%20API%20Token)
|
||||
</TabItem>
|
||||
<TabItem value="cli" label="goose CLI">
|
||||
**Command**
|
||||
```sh
|
||||
npx mcp-remote https://observability.mcp.cloudflare.com/sse
|
||||
npx mcp-remote https://observability.mcp.cloudflare.com/mcp
|
||||
```
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
@@ -94,7 +94,7 @@ Choose one or more servers based on your needs. Here are the most popular config
|
||||
|
||||
2. Choose to add a `Command-line Extension`
|
||||
3. Give your extension a name: `cloudflare-observability`
|
||||
4. Enter the command: `npx mcp-remote https://observability.mcp.cloudflare.com/sse`
|
||||
4. Enter the command: `npx mcp-remote https://observability.mcp.cloudflare.com/mcp`
|
||||
5. Set timeout: `300` seconds
|
||||
6. Add environment variable:
|
||||
- Name: `CLOUDFLARE_API_TOKEN`
|
||||
@@ -107,10 +107,10 @@ Choose one or more servers based on your needs. Here are the most popular config
|
||||
|
||||
<Tabs groupId="interface">
|
||||
<TabItem value="ui" label="goose Desktop" default>
|
||||
[Launch the installer](goose://extension?cmd=npx&arg=mcp-remote&arg=https%3A%2F%2Fbindings.mcp.cloudflare.com%2Fsse&id=cloudflare-bindings&name=Cloudflare%20Workers%20Bindings&description=Build%20Workers%20applications%20with%20storage%2C%20AI%2C%20and%20compute%20primitives&env=CLOUDFLARE_API_TOKEN%3DCloudflare%20API%20Token)
|
||||
[Launch the installer](goose://extension?cmd=npx&arg=mcp-remote&arg=https%3A%2F%2Fbindings.mcp.cloudflare.com%2Fmcp&id=cloudflare-bindings&name=Cloudflare%20Workers%20Bindings&description=Build%20Workers%20applications%20with%20storage%2C%20AI%2C%20and%20compute%20primitives&env=CLOUDFLARE_API_TOKEN%3DCloudflare%20API%20Token)
|
||||
</TabItem>
|
||||
<TabItem value="cli" label="goose CLI">
|
||||
Command: `npx mcp-remote https://bindings.mcp.cloudflare.com/sse`
|
||||
Command: `npx mcp-remote https://bindings.mcp.cloudflare.com/mcp`
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
|
||||
@@ -118,10 +118,10 @@ Choose one or more servers based on your needs. Here are the most popular config
|
||||
|
||||
<Tabs groupId="interface">
|
||||
<TabItem value="ui" label="goose Desktop" default>
|
||||
[Launch the installer](goose://extension?cmd=npx&arg=mcp-remote&arg=https%3A%2F%2Fradar.mcp.cloudflare.com%2Fsse&id=cloudflare-radar&name=Cloudflare%20Radar&description=Get%20global%20Internet%20traffic%20insights%2C%20trends%2C%20URL%20scans%2C%20and%20other%20utilities&env=CLOUDFLARE_API_TOKEN%3DCloudflare%20API%20Token)
|
||||
[Launch the installer](goose://extension?cmd=npx&arg=mcp-remote&arg=https%3A%2F%2Fradar.mcp.cloudflare.com%2Fmcp&id=cloudflare-radar&name=Cloudflare%20Radar&description=Get%20global%20Internet%20traffic%20insights%2C%20trends%2C%20URL%20scans%2C%20and%20other%20utilities&env=CLOUDFLARE_API_TOKEN%3DCloudflare%20API%20Token)
|
||||
</TabItem>
|
||||
<TabItem value="cli" label="goose CLI">
|
||||
Command: `npx mcp-remote https://radar.mcp.cloudflare.com/sse`
|
||||
Command: `npx mcp-remote https://radar.mcp.cloudflare.com/mcp`
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
|
||||
|
||||
@@ -132,9 +132,8 @@ You'll need to re-authenticate once a day when using the Google Drive extension.
|
||||
│ ○ Built-in Extension
|
||||
// highlight-start
|
||||
│ ● Command-line Extension (Run a local command or script)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (SSE)
|
||||
│ ○ Remote Extension (Streaming HTTP)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (Streamable HTTP)
|
||||
└
|
||||
```
|
||||
|
||||
|
||||
@@ -69,9 +69,8 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
|
||||
│ ○ Built-in Extension
|
||||
// highlight-start
|
||||
│ ● Command-line Extension (Run a local command or script)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (SSE)
|
||||
│ ○ Remote Extension (Streaming HTTP)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (Streamable HTTP)
|
||||
└
|
||||
```
|
||||
|
||||
|
||||
@@ -22,16 +22,16 @@ This tutorial covers how to add the JetBrains extension to integrate with any Je
|
||||
<TabItem value="later" label="2025.2 and later" default>
|
||||
|
||||
Versions 2025.2 and later have built-in MCP server support and generate a dynamic configuration specific to your IDE instance.
|
||||
|
||||
The instructions in this tutorial show how to configure the recommended remote SSE extension. See your IDE's documentation for more details (e.g. [MCP Server](https://www.jetbrains.com/help/idea/mcp-server.html) for IntelliJ IDEA).
|
||||
|
||||
See your IDE's documentation for more details (e.g. [MCP Server](https://www.jetbrains.com/help/idea/mcp-server.html) for IntelliJ IDEA).
|
||||
|
||||
:::tip TLDR
|
||||
<Tabs groupId="interface">
|
||||
<TabItem value="ui" label="goose Desktop" default>
|
||||
Use `Add custom extension` in Settings → Extensions to add a `Server-Sent Events (SSE)` extension type with your IDE-specific SSE config.
|
||||
Use `Add custom extension` in Settings → Extensions with the command from `Copy Stdio Config` in your IDE.
|
||||
</TabItem>
|
||||
<TabItem value="cli" label="goose CLI">
|
||||
Use `goose configure` to add a `Remote Extension (SSE)` extension type with your IDE-specific SSE config.
|
||||
Use `goose configure` with the command from `Copy Stdio Config` in your IDE.
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
:::
|
||||
@@ -43,11 +43,11 @@ This tutorial covers how to add the JetBrains extension to integrate with any Je
|
||||
|
||||
1. Go to `Settings > Tools > MCP Server` in your IDE
|
||||
2. If needed, click `Enable MCP Server` to enable the MCP server
|
||||
3. Click `Copy SSE Config`
|
||||
3. Click `Copy Stdio Config`
|
||||
4. Click `OK` to save your changes and start the server
|
||||
5. Copy the `url` value from the config
|
||||
5. Copy the `command`, `args`, and `env` values from the config
|
||||
|
||||
2. Add the JetBrains extension to goose, replacing "YOUR_IDE_SPECIFIC_URL" in the instructions with the URL you copied:
|
||||
2. Add the JetBrains extension to goose using the command from the config:
|
||||
<Tabs groupId="interface">
|
||||
<TabItem value="ui" label="goose Desktop" default>
|
||||
1. Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar
|
||||
@@ -55,18 +55,26 @@ This tutorial covers how to add the JetBrains extension to integrate with any Je
|
||||
3. Click `Add custom extension`
|
||||
4. On the `Add custom extension` modal, enter the following:
|
||||
- **Extension Name**: JetBrains
|
||||
- **Type**: Server-Sent Events (SSE)
|
||||
- **Endpoint**: YOUR_IDE_SPECIFIC_URL
|
||||
- **Type**: STDIO
|
||||
- **Description**: Integrate goose with any JetBrains IDE
|
||||
- **Command**: Combine the `command` and `args` from your IDE's Stdio config into a single command string
|
||||
- **Environment Variables**: Add `IJ_MCP_SERVER_PORT` with the port value from the `env` section of your copied Stdio config
|
||||
5. Click `Add Extension` to save the extension
|
||||
6. Navigate to the chat
|
||||
</TabItem>
|
||||
<TabItem value="cli" label="goose CLI">
|
||||
<CLIExtensionInstructions
|
||||
<CLIExtensionInstructions
|
||||
name="jetbrains"
|
||||
description="Integrate goose with any JetBrains IDE"
|
||||
type="sse"
|
||||
url="YOUR_IDE_SPECIFIC_URL"
|
||||
type="stdio"
|
||||
command="YOUR_COMMAND_AND_ARGS_FROM_IDE"
|
||||
timeout={300}
|
||||
envVars={[{ key: "IJ_MCP_SERVER_PORT", value: "YOUR_PORT_FROM_IDE" }]}
|
||||
commandNote={
|
||||
<>
|
||||
Combine <code>command</code> and <code>args</code> into a single string. The port value comes from the <code>env</code> section of your copied Stdio config.
|
||||
</>
|
||||
}
|
||||
/>
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
@@ -158,8 +166,8 @@ Anthropic's Claude 4 Sonnet was used for this task.
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
|
||||
:::tip
|
||||
When using goose to refactor code, it's recommended to commit your code to version control _before_ making changes. This way, you have a clean snapshot to compare against, making it easy to review goose’s modifications, revert if needed, and track improvements.
|
||||
:::tip
|
||||
When using goose to refactor code, it's recommended to commit your code to version control _before_ making changes. This way, you have a clean snapshot to compare against, making it easy to review goose's modifications, revert if needed, and track improvements.
|
||||
:::
|
||||
|
||||
### goose Prompt
|
||||
@@ -175,7 +183,7 @@ After 2 minutes, goose was done with the upgrade! 🎉
|
||||
I'll make several improvements to modernize this codebase to use Java 21 (latest LTS) features. Here are the changes I'll implement:
|
||||
|
||||
1. Update the `pom.xml` to use Java 21
|
||||
2. Use newer Java features
|
||||
2. Use newer Java features
|
||||
|
||||
[... code changes ...]
|
||||
|
||||
@@ -248,7 +256,6 @@ The codebase is now using the latest Java LTS version (21) and incorporates many
|
||||
|
||||
|
||||
|
||||
|
||||
Using the JetBrains extension provided several advantages and made it easier for goose to:
|
||||
- navigate through the codebase
|
||||
- track changes
|
||||
|
||||
@@ -19,40 +19,22 @@ This tutorial covers how to add the [Pieces for Developers MCP Server](https://d
|
||||
|
||||
2. Enable [Long-Term Memory Context](https://docs.pieces.app/products/quick-guides/ltm-context) in PiecesOS
|
||||
|
||||
3. Locate your MCP Server URL
|
||||
- In PiecesOS, navigate to Settings > Model Context Protocol (MCP)
|
||||
- Copy the server URL
|
||||
|
||||
:::tip
|
||||
The default server URL is shown below. PiecesOS may use a different port if 39300 is already in use on your system:
|
||||
|
||||
```
|
||||
http://localhost:39300/model_context_protocol/2024-11-05/sse
|
||||
```
|
||||
:::
|
||||
|
||||
### Add Pieces MCP Server
|
||||
|
||||
<Tabs groupId="interface">
|
||||
<TabItem value="ui" label="goose Desktop" default>
|
||||
<GooseDesktopInstaller
|
||||
extensionId="pieces"
|
||||
extensionName="Pieces for Developers"
|
||||
description="Provides access to your Pieces Long-Term Memory. You need to have Pieces installed to use this."
|
||||
url="http://localhost:39300/model_context_protocol/2024-11-05/sse"
|
||||
command="uvx"
|
||||
args={["--from", "pieces-cli", "pieces", "--ignore-onboarding", "mcp", "start"]}
|
||||
/>
|
||||
</TabItem>
|
||||
<TabItem value="cli" label="goose CLI">
|
||||
<CLIExtensionInstructions
|
||||
name="Pieces"
|
||||
description="Provides access to your Pieces Long-Term Memory"
|
||||
type="sse"
|
||||
url="http://localhost:39300/model_context_protocol/2024-11-05/sse"
|
||||
commandNote={
|
||||
<>
|
||||
Use the server URL you copied from PiecesOS settings. PiecesOS may use a different port if 39300 is already in use on your system.
|
||||
</>
|
||||
}
|
||||
type="stdio"
|
||||
command="uvx --from pieces-cli pieces --ignore-onboarding mcp start"
|
||||
/>
|
||||
</TabItem>
|
||||
</Tabs>
|
||||
@@ -74,7 +56,7 @@ Here's a report summarizing your key activities from yesterday, based on the mos
|
||||
|
||||
1. Code Development with goose:
|
||||
|
||||
Activity: You worked on integrating SSE MCP servers into the goose CLI, making enhancements to handle extensions via schema URLs.
|
||||
Activity: You worked on integrating MCP servers into the goose CLI, making enhancements to handle extensions via schema URLs.
|
||||
Description: This task involved modifying code and testing new integrations to support advanced functionalities. It also included interactions with the goose community on Discord for feedback and troubleshooting.
|
||||
|
||||
2. Documentation Updates:
|
||||
@@ -96,11 +78,11 @@ Here's a report summarizing your key activities from yesterday, based on the mos
|
||||
|
||||
Activity: Planned integration workflows for MCP and documented their use cases.
|
||||
Description: You worked on strategies for implementing MCP integrations effectively, involving planning sessions to optimize future project deployments and align them with user requirements and project objectives.
|
||||
|
||||
|
||||
These activities demonstrate a productive day with a focus on development, collaboration, and content management within your technical community.
|
||||
```
|
||||
|
||||
|
||||
:::tip
|
||||
For more examples of prompts you can use with the Pieces for Developers MCP Server, see the [Pieces MCP prompting guide](https://docs.pieces.app/products/mcp/prompting?utm_source=goose&utm_medium=collab&utm_campaign=mcp).
|
||||
:::
|
||||
:::
|
||||
|
||||
@@ -94,9 +94,8 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
|
||||
│ ○ Built-in Extension
|
||||
// highlight-start
|
||||
│ ● Command-line Extension (Run a local command or script)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (SSE)
|
||||
│ ○ Remote Extension (Streaming HTTP)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (Streamable HTTP)
|
||||
└
|
||||
```
|
||||
|
||||
|
||||
@@ -63,9 +63,8 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
|
||||
│ ○ Built-in Extension
|
||||
// highlight-start
|
||||
│ ● Command-line Extension (Run a local command or script)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (SSE)
|
||||
│ ○ Remote Extension (Streaming HTTP)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (Streamable HTTP)
|
||||
└
|
||||
```
|
||||
|
||||
|
||||
@@ -69,9 +69,8 @@ Before adding this extension, make sure [PortAudio](https://github.com/GoogleClo
|
||||
│ ○ Built-in Extension
|
||||
// highlight-start
|
||||
│ ● Command-line Extension (Run a local command or script)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (SSE)
|
||||
│ ○ Remote Extension (Streaming HTTP)
|
||||
// highlight-end
|
||||
│ ○ Remote Extension (Streamable HTTP)
|
||||
└
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user