github-mpc

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

MCP ServerPurposeRequiredFeatures Useduser-atlassianConfluence search/publish, Jira integrationYessearchConfluenceUsingCql, createConfluencePage, getConfluenceSpacesuser-githubRepository search, code explorationYessearch_repositories, search_code, get_file_contentsuser-FigmaDesign mockup retrievalOptionalget_file, get_imagesuser-elasticsearch-mcpLog analysis for request flow verificationOptionalsearch, get

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: Open Cursor Settings: Press Cmd/Ctrl + , to open settings Navigate to "MCP Servers" or "Extensions" Add Atlassian MCP: Search for "Atlassian" in the MCP marketplace Install the official Atlassian MCP server Or add manually to mcp.json (official Atlassian remote MCP): { "atlassian-mcp": { "url": "https://mcp.atlassian.com/v1/mcp" } } Authenticate: When prompted, authorize access to your Atlassian account Grant access to the Trading212 workspace Ensure you have access to the GT Confluence space Verify Installation: Restart Cursor Run the verification check in Step 1.2

2.2: GitHub MCP Setup

If user-github is not configured: Install GitHub MCP: Usually pre-installed with Cursor If missing, add to mcp_servers.json: { "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" } } } Configure GitHub Token: Create a Personal Access Token at github.com/settings/tokens Grant repo and read:org scopes Set as environment variable: export GITHUB_TOKEN=your_token Verify Access: Test with a simple repository search 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

IssueCauseSolution"MCP server not found"MCP not installedFollow Step 2 setup guide"Authentication failed"Token expired/invalidRe-authenticate in Cursor settings"Permission denied" for GT spaceConfluence permissionsRequest access from Confluence admin"Rate limited"Too many API callsWait and retry, or use caching"Cloud ID not found"Wrong Atlassian instanceUse getAccessibleAtlassianResources to find correct ID

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: Phase 1: Use Atlassian MCP to search for existing documentation Phase 4: Use Atlassian MCP to populate Related Pages and optionally publish Throughout: Use GitHub MCP for repository discovery and code search See product-guide-writer/SKILL.md for the full workflow.