MCP Prerequisites Setup

A skill for verifying and configuring the required MCP (Model Context Protocol) servers for the Product Guide Writer workflow.

Overview

The Product Guide Writer relies on several MCP servers to provide external integrations. This skill helps verify that required MCPs are configured and guides users through setup if needed.

When to Use

Use this skill when: - Starting the Product Guide Writer for the first time - Encountering MCP-related errors during documentation workflow - Setting up a new development environment - Troubleshooting Confluence/GitHub integration issues

Required MCP Servers

Step 1: Verify MCP Status

1.1: Check Enabled MCP Servers

The agent should verify MCP availability by checking the MCP configuration folder:

/Users/{username}/.cursor/projects/{workspace}/mcps/

Look for these directories: - user-atlassian/ - Atlassian MCP (required) - user-github/ - GitHub MCP (required) - user-Figma/ - Figma MCP (optional) - user-elasticsearch-mcp/ - Elasticsearch MCP (optional)

1.2: Test Atlassian MCP Connection

Use the getAccessibleAtlassianResources tool to verify Atlassian authentication:

Tool: CallMcpTool
Server: user-atlassian
ToolName: getAccessibleAtlassianResources
Arguments: {}

Expected Response: List of accessible Atlassian Cloud instances including Trading212.

If Error: Guide user through authentication (see Step 2).

1.3: Verify GT Space Access

Confirm access to the Product Documentation space:

Tool: CallMcpTool
Server: user-atlassian
ToolName: getConfluenceSpaces
Arguments:
  cloudId: "trading212.atlassian.net"
  keys: ["GT"]

Expected Response: Space details for GT (Product Documentation space).

If Error: User may need additional Confluence permissions.

Step 2: MCP Configuration Guide

If any required MCP is missing or misconfigured, guide the user:

2.1: Atlassian MCP Setup

If user-atlassian is not configured:

1. Open Cursor Settings:
2. Press Cmd/Ctrl + , to open settings

3. Navigate to "MCP Servers" or "Extensions"

   想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

4. Add Atlassian MCP:

5. Search for "Atlassian" in the MCP marketplace
6. Install the official Atlassian MCP server

7. Or add manually to mcp.json (official Atlassian remote MCP): json { "atlassian-mcp": { "url": "https://mcp.atlassian.com/v1/mcp" } }

8. Authenticate:

9. When prompted, authorize access to your Atlassian account
10. Grant access to the Trading212 workspace

11. Ensure you have access to the GT Confluence space

12. Verify Installation:

13. Restart Cursor
14. Run the verification check in Step 1.2

2.2: GitHub MCP Setup

If user-github is not configured:

1. Install GitHub MCP:
2. Usually pre-installed with Cursor

3. If missing, add to mcp_servers.json: json { "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" } } }

4. Configure GitHub Token:

5. Create a Personal Access Token at github.com/settings/tokens
6. Grant repo and read:org scopes

7. Set as environment variable: export GITHUB_TOKEN=your_token

8. Verify Access:

9. Test with a simple repository search
10. Ensure access to Trading212 organization

2.3: Optional MCPs

Figma MCP (for UI documentation): - Install: @anthropic/mcp-server-figma - Requires Figma access token - Useful for documenting user-facing features

Elasticsearch MCP (for log verification): - Install: @anthropic/mcp-server-elasticsearch - Requires Elasticsearch cluster access - Used in Phase 4 verification

Step 3: Configuration Validation

After setup, run a full validation:

3.1: Validation Checklist

## MCP Configuration Status

### Required MCPs
- [ ] user-atlassian: Connected to trading212.atlassian.net
- [ ] user-github: Connected to Trading212 organization

### Optional MCPs
- [ ] user-Figma: {Connected / Not configured}
- [ ] user-elasticsearch-mcp: {Connected / Not configured}

### Confluence Access
- [ ] GT Space accessible: trading212.atlassian.net/wiki/spaces/gt
- [ ] Can search pages: searchConfluenceUsingCql works
- [ ] Can create pages: createConfluencePage permission confirmed

### GitHub Access
- [ ] Can search repositories: search_repositories works
- [ ] Can search code: search_code works
- [ ] Trading212 org accessible

3.2: Test Search

Perform a test search to confirm full functionality:

Tool: CallMcpTool
Server: user-atlassian
ToolName: searchConfluenceUsingCql
Arguments:
  cloudId: "trading212.atlassian.net"
  cql: "space = GT AND type = page"
  limit: 5

If this returns results, Atlassian MCP is fully configured.

Troubleshooting

Quick Reference

Atlassian Cloud ID

trading212.atlassian.net

GT Space Details

Space Key: GT
Space Name: Product Documentation
URL: https://trading212.atlassian.net/wiki/spaces/gt

Useful CQL Queries

Find all product guides:

space = GT AND type = page AND title ~ "Product Guide"

Find guides for specific OTT:

space = GT AND type = page AND text ~ "{ott-name}"

Find recently updated pages:

space = GT AND type = page AND lastmodified >= now("-30d")

Integration with Product Guide Writer

Once MCPs are configured, the Product Guide Writer will:

1. Phase 1: Use Atlassian MCP to search for existing documentation
2. Phase 4: Use Atlassian MCP to populate Related Pages and optionally publish
3. Throughout: Use GitHub MCP for repository discovery and code search

See product-guide-writer/SKILL.md for the full workflow.

這個Skill質量中等，主要是一個配置檢查清單，幫助你確認MCP伺服器是否設定正確。優點是說明清晰、步驟詳細，告訴你怎麼檢查和配置Atlassian、GitHub等工具。不足是缺少自動檢測功能，需要手動一步步驗證，而且文件內容偏向技術說明，對普通使用者不太友好。如果你需要的是一個能自動幫你檢查配置的智慧工具，這個Skill可能不太滿足需求。