Skip to content

Commit 41da12b

Browse files
sjnimsclaude
andcommitted
fix: restore MCP tool naming patterns corrupted by prettier
Prettier was converting `__` to `**` in MCP tool names like `mcp__plugin_name__tool`, treating double underscores as emphasis. - Restore correct `mcp__` patterns in SKILL.md and tool-usage.md - Add .prettierignore to exclude these files from prettier formatting Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent b7a62af commit 41da12b

3 files changed

Lines changed: 28 additions & 24 deletions

File tree

.prettierignore

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# MCP integration docs use mcp__plugin_*__* patterns that prettier
2+
# incorrectly converts __ to ** (treating as emphasis)
3+
plugins/plugin-dev/skills/mcp-integration/SKILL.md
4+
plugins/plugin-dev/skills/mcp-integration/references/tool-usage.md

plugins/plugin-dev/skills/mcp-integration/SKILL.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -376,12 +376,12 @@ Commands use MCP tools with user interaction:
376376

377377
---
378378

379-
allowed-tools: mcp**plugin_name_server**create_item
379+
allowed-tools: `mcp__plugin_name_server__create_item`
380380

381381
Steps:
382382

383383
1. Gather item details from user
384-
2. Use mcp**plugin_name_server**create_item
384+
2. Use `mcp__plugin_name_server__create_item`
385385
3. Confirm creation
386386
```
387387

@@ -396,7 +396,7 @@ Agents use MCP tools autonomously:
396396

397397
Analysis Process:
398398

399-
1. Query data via mcp**plugin_db_server**query
399+
1. Query data via `mcp__plugin_db_server__query`
400400
2. Process and analyze results
401401
3. Generate insights report
402402
```
@@ -452,9 +452,9 @@ Always use secure connections:
452452
Pre-allow only necessary MCP tools:
453453

454454
```markdown
455-
✅ allowed-tools: mcp**plugin_api_server**read_data, mcp**plugin_api_server**create_item
455+
✅ allowed-tools: `mcp__plugin_api_server__read_data`, `mcp__plugin_api_server__create_item`
456456

457-
❌ allowed-tools: mcp**plugin_api_server**\*
457+
❌ allowed-tools: mcp__plugin_api_server__*
458458
```
459459

460460
### Managed MCP Controls (Enterprise)

plugins/plugin-dev/skills/mcp-integration/references/tool-usage.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ allowed-tools: mcp__plugin_asana_asana__asana_create_task
6060
To create a task:
6161

6262
1. Gather task details from user
63-
2. Use mcp**plugin_asana_asana**asana_create_task with the details
63+
2. Use mcp__\1__asana_create_task with the details
6464
3. Confirm creation to user
6565
```
6666

@@ -98,7 +98,7 @@ allowed-tools: mcp__plugin_asana_asana__asana_search_tasks, mcp__plugin_asana_as
9898

9999
To search for tasks:
100100

101-
1. Use mcp**plugin_asana_asana**asana_search_tasks
101+
1. Use mcp__\1__asana_search_tasks
102102
2. Provide search filters (assignee, project, etc.)
103103
3. Display results to user
104104

@@ -112,7 +112,7 @@ To create a task:
112112
- Project
113113
- Assignee
114114
- Due date
115-
2. Use mcp**plugin_asana_asana**asana_create_task
115+
2. Use mcp__\1__asana_create_task
116116
3. Show confirmation with task link
117117
```
118118

@@ -136,10 +136,10 @@ Autonomous agent for generating Asana project status reports.
136136

137137
## Process
138138

139-
1. **Query tasks**: Use mcp**plugin_asana_asana**asana_search_tasks to get all tasks
139+
1. **Query tasks**: Use mcp__\1__asana_search_tasks to get all tasks
140140
2. **Analyze progress**: Calculate completion rates and identify blockers
141141
3. **Generate report**: Create formatted status update
142-
4. **Update Asana**: Use mcp**plugin_asana_asana**asana_create_comment to post report
142+
4. **Update Asana**: Use mcp__\1__asana_create_comment to post report
143143

144144
## Available Tools
145145

@@ -164,7 +164,7 @@ Single tool call with validation:
164164
Steps:
165165

166166
1. Validate user provided required fields
167-
2. Call mcp**plugin_api_server**create_item with validated data
167+
2. Call mcp__\1__create_item with validated data
168168
3. Check for errors
169169
4. Display confirmation
170170
```
@@ -176,9 +176,9 @@ Chain multiple tool calls:
176176
```markdown
177177
Steps:
178178

179-
1. Search for existing items: mcp**plugin_api_server**search
180-
2. If not found, create new: mcp**plugin_api_server**create
181-
3. Add metadata: mcp**plugin_api_server**update_metadata
179+
1. Search for existing items: mcp__\1__search
180+
2. If not found, create new: mcp__\1__create
181+
3. Add metadata: mcp__\1__update_metadata
182182
4. Return final item ID
183183
```
184184

@@ -191,7 +191,7 @@ Steps:
191191

192192
1. Get list of items to process
193193
2. For each item:
194-
- Call mcp**plugin_api_server**update_item
194+
- Call mcp__\1__update_item
195195
- Track success/failure
196196
3. Report results summary
197197
```
@@ -203,7 +203,7 @@ Graceful error handling:
203203
```markdown
204204
Steps:
205205

206-
1. Try to call mcp**plugin_api_server**get_data
206+
1. Try to call mcp__\1__get_data
207207
2. If error (rate limit, network, etc.):
208208
- Wait and retry (max 3 attempts)
209209
- If still failing, inform user
@@ -328,7 +328,7 @@ Steps:
328328
```markdown
329329
Steps:
330330

331-
1. Call mcp**plugin_api_server**search with filters:
331+
1. Call mcp__\1__search with filters:
332332
- project_id: "123"
333333
- status: "active"
334334
- limit: 100
@@ -341,7 +341,7 @@ Steps:
341341
Steps:
342342

343343
1. For each item ID:
344-
- Call mcp**plugin_api_server**get_item
344+
- Call mcp__\1__get_item
345345
- Process item
346346
```
347347

@@ -350,7 +350,7 @@ Steps:
350350
```markdown
351351
Steps:
352352

353-
1. Call expensive MCP operation: mcp**plugin_api_server**analyze
353+
1. Call expensive MCP operation: mcp__\1__analyze
354354
2. Store results in variable for reuse
355355
3. Use cached results for subsequent operations
356356
4. Only re-fetch if data changes
@@ -364,9 +364,9 @@ When tools don't depend on each other, call in parallel:
364364
Steps:
365365

366366
1. Make parallel calls (Claude handles this automatically):
367-
- mcp**plugin_api_server**get_project
368-
- mcp**plugin_api_server**get_users
369-
- mcp**plugin_api_server**get_tags
367+
- mcp__\1__get_project
368+
- mcp__\1__get_users
369+
- mcp__\1__get_tags
370370
2. Wait for all to complete
371371
3. Combine results
372372
```
@@ -381,7 +381,7 @@ Steps:
381381
Steps:
382382

383383
1. Inform user: "Searching Asana tasks..."
384-
2. Call mcp**plugin_asana_asana**asana_search_tasks
384+
2. Call mcp__\1__asana_search_tasks
385385
3. Show progress: "Found 15 tasks, analyzing..."
386386
4. Present results
387387
```
@@ -507,7 +507,7 @@ Use delete_item with item ID (ask for confirmation first)...
507507
```markdown
508508
Steps:
509509

510-
1. **Search**: mcp**plugin_api_server**search with filters
510+
1. **Search**: mcp__\1__search with filters
511511
2. **Filter**: Apply additional local filtering if needed
512512
3. **Transform**: Process each result
513513
4. **Present**: Format and display to user

0 commit comments

Comments
 (0)