# Getting Started

## MCP Server Setup Guides (Docker)

This folder contains Docker setup guides for all MCP servers used in The Entourage AI operations.

> **Important:** All MCP servers should be configured with @theentourageai.com work accounts, NOT personal accounts.

### Quick Reference

| MCP Server    | Purpose                                | SOPs Using       | Setup Guide            |
| ------------- | -------------------------------------- | ---------------- | ---------------------- |
| **n8n-mcp**   | Workflow building, testing, validation | 3, 7, 12, 14     | n8n-mcp-setup.md       |
| **gmail**     | Email sending, drafting, searching     | All (via skills) | gmail-mcp-setup.md     |
| **gcalendar** | Meeting scheduling, availability       | 1, 2, 10, 11     | gcalendar-mcp-setup.md |
| **gdrive**    | File search, document storage          | 1, 5, 14         | gdrive-mcp-setup.md    |
| **slack**     | Internal reviews, notifications        | 8, 14            | slack-mcp-setup.md     |

***

### Prerequisites (All Servers)

1. **Docker Desktop** installed and running
2. Relevant API credentials (see individual guides)
3. Claude Code installed

***

### Quick Start Commands

#### Pull All Images

```bash
# n8n MCP
docker pull ghcr.io/czlonkowski/n8n-mcp:latest

# Gmail MCP
docker pull mcp/gmail

# Google Calendar MCP
docker pull ghcr.io/metorial/mcp-container--nspady--google-calendar-mcp--google-calendar-mcp

# Google Drive MCP
docker pull mcp/gdrive

# Slack MCP
docker pull mcp/slack
```

#### Verify All Running

```bash
# Check all MCP images are available
docker images | grep -E "mcp|n8n-mcp|gcalendar|gdrive|slack"
```

***

### Claude Code Configuration

Add all servers to `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "n8n-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "N8N_API_URL=https://your-n8n-instance.com",
        "-e", "N8N_API_KEY=n8n_api_xxxxx",
        "ghcr.io/czlonkowski/n8n-mcp:latest"
      ]
    },
    "gmail": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "gmail-mcp-tokens:/app/tokens",
        "mcp/gmail"
      ]
    },
    "gcalendar": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "~/.gcalendar-mcp:/app/config",
        "ghcr.io/metorial/mcp-container--nspady--google-calendar-mcp--google-calendar-mcp"
      ]
    },
    "gdrive": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "mcp-gdrive:/mcp-gdrive",
        "mcp/gdrive"
      ]
    },
    "slack": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SLACK_BOT_TOKEN=xoxb-your-token",
        "-e", "SLACK_TEAM_ID=TXXXXXXXX",
        "mcp/slack"
      ]
    }
  }
}
```

***

### Setup Order (Recommended)

1. **Gmail** - Used in almost every SOP for client communication
2. **Google Calendar** - For scheduling and availability checks
3. **n8n MCP** - Core workflow operations
4. **Google Drive** - Document storage and retrieval
5. **Slack** - Internal team communication

***

### Authentication Summary

| Server          | Auth Method               | Credentials Needed                 | Account             |
| --------------- | ------------------------- | ---------------------------------- | ------------------- |
| n8n-mcp         | API Key                   | n8n API URL + API Key              | N/A                 |
| Gmail           | OAuth 2.0 or App Password | Google Cloud OAuth OR App Password | @theentourageai.com |
| Google Calendar | OAuth 2.0                 | Google Cloud OAuth credentials     | @theentourageai.com |
| Google Drive    | OAuth 2.0                 | Google Cloud OAuth credentials     | @theentourageai.com |
| Slack           | Bot Token                 | Slack App Bot Token + Team ID      | TEAI Workspace      |

#### Team Email Accounts

| Team Member                  | Email                        |
| ---------------------------- | ---------------------------- |
| Mac (CEO)                    | <mac@theentourageai.com>     |
| Rey (AI Solutions Engineer)  | <rey@theentourageai.com>     |
| Zac (AI Solutions Engineer)  | <zac@theentourageai.com>     |
| Dan (Head of AI Engineering) | <dan@theentourageai.com>     |
| Support                      | <support@theentourageai.com> |

***

### Common Issues

| Issue              | Solution                             |
| ------------------ | ------------------------------------ |
| Docker not running | Start Docker Desktop                 |
| Image not found    | Run `docker pull` command            |
| Auth failed        | Re-run authentication flow           |
| Permission denied  | Check OAuth scopes / bot permissions |
| Connection refused | Verify Docker has network access     |

***

### MCP Tools by Server

#### n8n-mcp

* `n8n_create_workflow`, `n8n_get_workflow`, `n8n_update_full_workflow`
* `n8n_validate_workflow`, `n8n_test_workflow`, `n8n_executions`
* `search_nodes`, `get_node`, `validate_node`

#### gmail

* `search_emails`, `read_email`, `send_email`, `draft_email`
* `modify_email`, `list_email_labels`, `create_label`, `create_filter`

#### gcalendar

* `list-calendars`, `list-events`, `search-events`, `get-event`
* `create-event`, `update-event`, `delete-event`, `get-freebusy`

#### gdrive

* `search`, `list`, `read`, `get_file_info`

#### slack

* `slack_list_channels`, `slack_post_message`, `slack_reply_to_thread`
* `slack_get_channel_history`, `slack_get_users`, `slack_add_reaction`

***

### Updating MCP Servers

```bash
# Pull latest versions
docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker pull mcp/gmail
docker pull ghcr.io/metorial/mcp-container--nspady--google-calendar-mcp--google-calendar-mcp
docker pull mcp/gdrive
docker pull mcp/slack

# Restart Claude Code to use new versions
```

***

### Resources

* [Model Context Protocol Docs](https://modelcontextprotocol.io/)
* [Docker MCP Catalog](https://hub.docker.com/search?q=mcp)
* [Anthropic MCP Servers](https://github.com/modelcontextprotocol/servers)