# Mcporter Setup

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-zocomputer-skills-mcporter-setup`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [zocomputer](https://agentstack.voostack.com/s/zocomputer)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [zocomputer](https://github.com/zocomputer)
- **Source:** https://github.com/zocomputer/skills/tree/main/Community/mcporter-setup

## Install

```sh
agentstack add skill-zocomputer-skills-mcporter-setup
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCPorter Setup

Install and configure MCP (Model Context Protocol) servers on Zo Computer. This skill handles the complete setup process from installation to working connection.

## When to Use

- User wants to use an MCP server but mcporter isn't installed
- User wants to add a new MCP server to their configuration
- User mentions a platform/service that might be available via MCP
- Troubleshooting MCP connection issues
- User asks "set up MCP" or "add MCP server"

---

## Setup Process

Follow these steps in order:

### Step 1: Check MCPorter Installation

Run the installation check script:

```bash
bun Skills/mcporter-setup/scripts/check-install.ts
```

If not installed, the script will install mcporter automatically.

### Step 2: Gather MCP Server Details

Ask the user for the following information:

| Required | Question | Example |
|----------|----------|---------|
| **Server URL** | "What is the MCP server URL?" | `https://mcp.example.com/mcp` |
| **Server Name** | "What name would you like for this server?" | `myserver` |
| **Description** | "What does this server provide?" | `My API integration` |

### Step 3: Determine Authentication Method

Check the server's auth requirements:

```bash
bun Skills/mcporter-setup/scripts/detect-auth.ts 
```

This will return one of:
- `none` - No authentication required
- `oauth` - Standard OAuth (browser-based)
- `api-key` - API key in header
- `bearer` - Bearer token
- `custom` - Non-standard auth (requires manual setup)

### Step 4: Handle Authentication

Based on the auth type:

#### No Auth
Proceed directly to Step 5.

#### OAuth
Run the auth flow:
```bash
npx mcporter auth 
```
Tell the user: "A browser window will open for authentication. Please complete the login and return here."

#### API Key / Bearer Token
Ask the user:
1. "What is the header name for the API key?" (e.g., `x-api-key`, `Authorization`)
2. "What is your API key or token?"

Then store the secret:
```bash
# Tell user to add secret in Settings > Advanced
# Then reference it in config
```

**For API keys:** Direct the user to [Settings > Advanced](/?t=settings&s=advanced) to add the secret, then continue with the variable reference.

### Step 5: Add Server Configuration

Run the setup script with gathered information:

```bash
bun Skills/mcporter-setup/scripts/add-server.ts \
  --name "" \
  --url "" \
  --description "" \
  --auth-type "" \
  --header-name "" \
  --secret-var ""
```

### Step 6: Test Connection

Verify the setup works:

```bash
bun Skills/mcporter-setup/scripts/test-server.ts 
```

If successful, show the available tools:
```bash
npx mcporter list  --all-parameters
```

---

## Common MCP Servers

Use these pre-configured setups for popular services:

### Linear

```
URL: https://mcp.linear.app/mcp
Auth: Bearer token (LINEAR_API_KEY)
Header: Authorization: Bearer ${LINEAR_API_KEY}
```

Setup:
1. Get API key from Linear Settings > API
2. Store as `LINEAR_API_KEY` in Zo Secrets
3. Run: `npx mcporter config add linear https://mcp.linear.app/mcp --header "Authorization: Bearer ${LINEAR_API_KEY}" --scope home`

### Context7 (No Auth)

```
URL: https://mcp.context7.com/mcp
Auth: None
```

Setup:
```bash
npx mcporter config add context7 https://mcp.context7.com/mcp --description "Documentation search" --scope home
```

### GitHub MCP (STDIO)

```
Command: npx -y @github/mcp-server
Auth: GITHUB_TOKEN environment variable
```

Setup:
1. Create GitHub Personal Access Token
2. Store as `GITHUB_TOKEN` in Zo Secrets
3. Run: `npx mcporter config add github --command "npx" --arg "-y" --arg "@github/mcp-server" --env "GITHUB_TOKEN=${GITHUB_TOKEN}" --scope home`

### Firecrawl

```
URL: https://mcp.firecrawl.dev/mcp
Auth: Bearer token (FIRECRAWL_API_KEY)
Header: Authorization: Bearer ${FIRECRAWL_API_KEY}
```

Setup:
1. Get API key from Firecrawl dashboard
2. Store as `FIRECRAWL_API_KEY` in Zo Secrets
3. Run: `npx mcporter config add firecrawl https://mcp.firecrawl.dev/mcp --header "Authorization: Bearer ${FIRECRAWL_API_KEY}" --scope home`

---

## Troubleshooting

### SSE Error / Invalid Content Type

The server may use a different transport or require custom auth:
1. Check server documentation
2. Try `--http-url` flag instead of SSE
3. May need manual token configuration

### Authentication Required (401/403)

Secret may not be loaded:
1. Verify secret exists in Zo Secrets
2. Check the environment variable name matches exactly
3. Test with: `curl -H "Authorization: Bearer $SECRET" `

### Tools Unavailable

Server may be offline or auth failed:
1. Test connectivity: `curl -v `
2. Re-run auth: `npx mcporter auth `
3. Check server status page if available

---

## Scripts

### `check-install.ts`
Checks if mcporter is installed and installs if needed.

### `detect-auth.ts `
Analyzes server auth requirements.

### `add-server.ts`
Adds server configuration with proper auth setup.

### `test-server.ts `
Tests server connectivity and lists available tools.

---

## After Setup

Once configured, use the `mcporter` skill for quick command reference:

```bash
npx mcporter list 
npx mcporter call . param=value
```

## References

- [MCPorter Documentation](https://github.com/steipete/mcporter)
- [MCP Server Registry](https://github.com/modelcontextprotocol/servers)
- [Zo Secrets](/?t=settings&s=advanced)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [zocomputer](https://github.com/zocomputer)
- **Source:** [zocomputer/skills](https://github.com/zocomputer/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zocomputer-skills-mcporter-setup
- Seller: https://agentstack.voostack.com/s/zocomputer
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.