Integration

MCP Server Integration

Extend CogTog's capabilities with Model Context Protocol (MCP) servers that provide specialized tools, resources, and data access.

Integration

What is MCP?

Model Context Protocol

MCP is an open protocol that standardizes how AI applications connect to external tools and data sources. It enables agents to access databases, APIs, file systems, and specialized services through a unified interface.

Tools

Functions that agents can call (e.g., database queries, API calls, file operations)

Resources

Data sources that agents can read (e.g., files, documentation, API endpoints)

Prompts

Reusable prompt templates with variables for common tasks

Official MCP Documentation

Learn more about the Model Context Protocol specification and available servers.

modelcontextprotocol.io

Installing MCP Servers

CogTog supports two ways to add MCP servers: stdio transport (local processes) and HTTP transport (remote servers).

Stdio Transport (Local)

Run MCP servers as local processes. Most common for npm packages and local scripts.

// Example: GitHub MCP Server

Command: npx

Args: ["-y", "@modelcontextprotocol/server-github"]

Env: { GITHUB_TOKEN: "your-token" }

HTTP Transport (Remote)

Connect to remote MCP servers via HTTP. Useful for hosted services and APIs.

// Example: Remote MCP Service

URL: https://mcp.example.com/api

Headers: { Authorization: "Bearer token" }

Smithery Registry

CogTog integrates with Smithery, a curated registry of MCP servers. Browse, discover, and install servers with one click.

Browse hundreds of pre-built MCP servers

One-click installation with automatic configuration

OAuth authentication for supported servers

Auto-updates and version management

Popular MCP Servers

GitHub

PostgreSQL

Google Drive

Slack

Puppeteer

Memory

Explore Smithery

Browse the MCP server registry

OAuth Authentication

Some MCP servers require OAuth authentication to access third-party services. CogTog handles the OAuth flow automatically.

Install Server

Choose an MCP server that requires OAuth (e.g., GitHub, Google Drive)

Authenticate

CogTog opens OAuth flow in your browser for secure authentication

Auto-Configure

Credentials are securely stored and automatically refreshed

How MCP Tools Work

When you connect an MCP server, its tools automatically appear in the agent's toolbox alongside built-in tools.

// Example: GitHub MCP Server provides these tools

- create_issue(repo, title, body)

- list_pull_requests(repo, state)

- search_repositories(query)

- get_file_contents(repo, path)

Automatic Discovery

Agents can call list_tools to see all available MCP tools

Seamless Integration

MCP tools work exactly like built-in tools - no special syntax needed

Permissions Apply

MCP tools respect the same permission system as built-in tools

Security Note

MCP tools can be powerful. Review tool permissions and only install servers from trusted sources. You can disable individual servers or tools at any time.

Creating Custom MCP Servers

You can create custom MCP servers to expose your own APIs, databases, or services to agents.

TypeScript/JavaScript

Use the official MCP SDK for Node.js

npm install @modelcontextprotocol/sdk

Python

Use the Python MCP SDK

pip install mcp

Any Language

Implement the JSON-RPC protocol over stdio or HTTP

MCP Server Quickstart

Learn how to build your first MCP server

Managing MCP Servers

Enable/Disable Servers

Temporarily disable MCP servers without uninstalling them. Disabled servers don't provide tools to agents.

Share with Organization

Share MCP server configurations with your team. Updates sync automatically across all team members.

Monitor Connections

View connection status, error logs, and usage statistics for each MCP server in the settings panel.

Update Credentials

Easily update environment variables and authentication tokens without reconfiguring the entire server.