Skip to content

Commit ab0cb84

Browse files
bdougieContinue
andcommitted
docs: clarify MCP YAML examples need context or block metadata
- Add ellipsis (...) to YAML examples to indicate they're part of a larger config file - Add explicit note about required metadata fields when creating standalone block files - This prevents confusion when users try to copy snippets directly into .continue/mcpServers/ Generated with [Continue](https://continue.dev) Co-Authored-By: Continue <[email protected]>
1 parent 94561f8 commit ab0cb84

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

docs/customize/deep-dives/mcp.mdx

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,15 +77,21 @@ block](https://hub.continue.dev/new?type=block&blockType=mcpServers) or add a lo
7777
server block to your [config file](./configuration.md):
7878

7979
```yaml title="config.yaml"
80+
# ...
8081
mcpServers:
8182
- name: SQLite MCP
8283
command: npx
8384
args:
8485
- "-y"
8586
- "mcp-sqlite"
8687
- "/path/to/your/database.db"
88+
# ...
8789
```
8890

91+
<Note>
92+
When creating a standalone block file in `.continue/mcpServers/`, remember to include the required metadata fields (`name`, `version`, `schema`) as shown in the Quick Start example above.
93+
</Note>
94+
8995
### How to Configure MCP Server Properties
9096

9197
MCP blocks follow the established syntax for blocks, with a few additional properties specific to MCP servers.
@@ -105,35 +111,41 @@ MCP now supports remote server connections through HTTP-based transports, expand
105111
For real-time streaming communication, use the SSE transport:
106112

107113
```yaml
114+
# ...
108115
mcpServers:
109116
- name: Name
110117
type: sse
111118
url: https://....
119+
# ...
112120
```
113121

114122
#### How to Use Standard Input/Output (`stdio`)
115123

116124
For local MCP servers that communicate via standard input and output:
117125

118126
```yaml
127+
# ...
119128
mcpServers:
120129
- name: Name
121130
type: stdio
122131
command: npx
123132
args:
124133
- "@modelcontextprotocol/server-sqlite"
125134
- "/path/to/your/database.db"
135+
# ...
126136
```
127137

128138
#### How to Use Streamable HTTP Transport
129139

130140
For standard HTTP-based communication with streaming capabilities:
131141

132142
```yaml
143+
# ...
133144
mcpServers:
134145
- name: Name
135146
type: streamable-http
136147
url: https://....
148+
# ...
137149
```
138150

139151
These remote transport options allow you to connect to MCP servers hosted on remote infrastructure, enabling more flexible deployment architectures and shared server resources across multiple clients.
@@ -146,6 +158,7 @@ With some MCP servers you will need to use API keys or other secrets. You can le
146158
as well as access hosted secrets in the Continue Hub. To leverage Hub secrets, you can use the `inputs` property in your MCP env block instead of `secrets`.
147159

148160
```yaml
161+
# ...
149162
mcpServers:
150163
- name: Supabase MCP
151164
command: npx
@@ -163,4 +176,5 @@ mcpServers:
163176
- "@modelcontextprotocol/server-github"
164177
env:
165178
GITHUB_PERSONAL_ACCESS_TOKEN: ${{ secrets.GITHUB_PERSONAL_ACCESS_TOKEN }}
179+
# ...
166180
```

0 commit comments

Comments
 (0)