Unified Context Layer

Fastn MCP サーバー

単一のマルチテナント MCP エンドポイントを通じて、AI エージェントやアプリに、顧客のツールやシステムへの安全でガバナンスの行き届いたアクセスを提供します。

SaaS 製品や AI エージェント向けの組み込み型統合プラットフォーム、Fastn の一部です。Fastn MCP Server は、本番環境に対応した Model Context Protocol（MCP） ゲートウェイです。AI エージェントやアプリを Slack、Jira、GitHub、Salesforce、HubSpot、Postgres など、200 以上のサービスに接続し、認証を完全に管理し、ガバナンスの行き届いたマルチテナントアクセスとサブ秒単位の実行を実現します。

Fastn SDK を基盤としており、互換性のある AI プラットフォームならすぐに利用できる MCP ツールを公開します。

Fastn MCP サーバーを選ぶ理由

特長	説明
250 以上のコネクター	Slack、Jira、GitHub、Salesforce、HubSpot、Postgres、Stripe、Notion、Linear など
MCP ネイティブ	Claude Desktop、Cursor、Lovable、Bolt、v0、および MCP 対応のあらゆるクライアントで動作します
認証を完全に管理	すべてのコネクターで OAuth 2.1 を利用でき、トークン管理、アプリ登録、トークン更新処理は不要です
ガバナンスの行き届いたアクセス	ロールベースの権限、監査証跡、エンタープライズ向けコンプライアンス制御を備えています
SOC 2 認証取得済み	エンタープライズレベルのセキュリティとコンプライアンスをプラットフォームに組み込んでいます
サブ秒単位の実行	キャッシュとコネクションプーリングを組み込んだ Fastn プラットフォーム経由の直接 API 呼び出し
複数のトランスポート	あらゆるデプロイモデルに対応する stdio（ローカル）、SSE、Streamable HTTP
本番環境対応	Docker のサポート、ヘルスチェック、構造化ログ、OAuth 2.1 保護リソースメタデータを備えています
フローの自動化	ツールを組み合わせた複数ステップのワークフローを作成、管理、実行できます

クイックスタート

1. app.fastn.ai に登録する

アカウントを作成し、最初のコネクター（Gmail、Slack、GitHub など）を接続します。

2. MCP クライアントを接続する

ホスト型サーバー（推奨）。インストールは不要です。

https://mcp.live.fastn.ai/shttp

この URL を任意の MCP クライアントに設定します。認証は MCP OAuth 2.1 によって自動的に処理されます。Claude Desktop と Cursor の例については、クライアントの設定を参照してください。

セルフホスト。独自のインスタンスをインストールして実行します。

pip install fastn-mcp-server
fastn-mcp --shttp --port 8000

MCP サーバーへの接続

エンドポイント

ホスト型サーバー（mcp.live.fastn.ai）またはセルフホストのインスタンスを使用します。各パスでは、異なるツールセットが公開されます。

エンドポイント	ツール
/shttp	すべての 11 個のツール：find_tools、execute_tool、list_connectors、list_skills、list_projects、list_flows、run_flow、delete_flow、create_flow、update_flow、configure_custom_auth
/shttp/tools	5 個のツール：find_tools、execute_tool、list_connectors、list_skills、list_projects
/shttp/tools/{project_id}	4 個のツール：find_tools、execute_tool、list_connectors、list_skills
/shttp/tools/{project_id}/{skill_id}	3 個のツール：find_tools、execute_tool、list_connectors
/sse、/sse/tools など	SSE トランスポートでも同じパターンです

ホスト型サーバーの使用例：

https://mcp.live.fastn.ai/shttp                              # All tools
https://mcp.live.fastn.ai/shttp/tools                           # Fastn tools only
https://mcp.live.fastn.ai/shttp/tools/{project_id}              # Pre-set project
https://mcp.live.fastn.ai/shttp/tools/{project_id}/{skill_id}   # Pre-set project + skill

認証

MCP サーバーは 3 つの認証方法をサポートしています。認証情報は app.fastn.ai から取得してください。

MCP OAuth 2.1（推奨）

PKCE を使用する標準的な MCP OAuth フローです。サーバーが Fastn の ID プロバイダーと自動的に連携します。クライアントに URL を設定するだけで、認証を求められます。

{
  "mcpServers": {
    "tools": {
      "url": "https://mcp.live.fastn.ai/shttp"
    }
  }
}

トークン／API キー

MCP クライアントの設定で、Authorization ヘッダーを介して Fastn 認証トークンまたは API キーを渡します。

{
  "mcpServers": {
    "tools": {
      "url": "https://mcp.live.fastn.ai/shttp",
      "headers": {
        "Authorization": "Bearer <your-token-or-api-key>"
      }
    }
  }
}

特定のプロジェクトにリクエストを限定するため、x-project-id を渡すこともできます。

{
  "mcpServers": {
    "tools": {
      "url": "https://mcp.live.fastn.ai/shttp",
      "headers": {
        "Authorization": "Bearer <your-token-or-api-key>",
        "x-project-id": "<your-project-id>"
      }
    }
  }
}

ローカルの stdio トランスポートでは、認証情報を環境変数として渡します。

{
  "mcpServers": {
    "tools": {
      "command": "fastn-mcp",
      "args": ["--stdio"],
      "env": {
        "FASTN_API_KEY": "your-api-key",
        "FASTN_PROJECT_ID": "your-project-id"
      }
    }
  }
}

MCP ツール

サーバーは AI エージェントに以下のツールを公開します。

Fastn ツール

ツール	説明
find_tools	自然言語のプロンプトで利用可能なコネクタツールを検索します。一致するツールと ID、入力スキーマを返します。
execute_tool	パラメーターを指定し、ID でコネクタツールを実行します。結果を直接返します。
list_connectors	レジストリ内の利用可能な 250 以上のコネクタを参照します。まだ接続されていないコネクタも含まれます。
list_skills	プロジェクトで利用可能なスキルを一覧表示します。
list_projects	認証済みユーザーが利用できるプロジェクトを一覧表示します。

ワークフロー： コネクタを参照するには、list_connectors を使用します。アクションを実行するには、find_tools → execute_tool の順に使用します。find_tools で関連する結果が返されない場合は、list_connectors を使用します（コネクタの接続が必要な場合があります）。

フロー管理

ツール	説明
list_flows	プロジェクトに保存されている自動化（フロー）を一覧表示します。
run_flow	ID を指定して、保存済みのフローを実行します。
delete_flow	プロジェクトからフローを削除します。
create_flow	(開発中) 自然言語からフローを作成します。
update_flow	(開発中) 既存のフローを更新します。

設定

ツール	説明
configure_custom_auth	カスタム JWT 認証プロバイダー（Auth0、Firebase、Supabase）を登録します。

アーキテクチャ

AI Agent (Claude, Cursor, Lovable)
    │
    ▼
MCP Protocol (stdio / SSE / Streamable HTTP)
    │
    ▼
┌─────────────────────────────┐
│   Fastn MCP Server          │
│   ┌───────────────────────┐ │
│   │ Tool Discovery        │ │  find_tools, list_connectors
│   │ Tool Execution        │ │  execute_tool
│   │ Flow Management       │ │  list/run/delete/create flows
│   │ Auth & Config         │ │  OAuth 2.1, custom JWT
│   └───────────────────────┘ │
└─────────────────────────────┘
    │
    ▼
Fastn SDK → Fastn API
    │
    ▼
250+ Connectors (Slack, Jira, GitHub, Salesforce, Postgres, ...)

コネクタはツールを提供します。フローはツールを組み合わせます。エージェントは推論を行いながらフローとツールを実行します。

クライアントの設定

上記の JSON の例は、どの MCP クライアントでも使用できます。設定ファイルの場所は次のとおりです。

クライアント	設定ファイル
Claude Desktop	claude_desktop_config.json
Cursor	プロジェクト内の .cursor/mcp.json
Claude Code	プロジェクト内の .mcp.json

Cursor では、Fastn ツールのみを公開するために /shttp/tools エンドポイントを使用してください（コーディングアシスタントに推奨）。

{
  "mcpServers": {
    "tools": {
      "url": "https://mcp.live.fastn.ai/shttp/tools"
    }
  }
}

セルフホスティング

トランスポートモード

stdio（ローカル）。パイプベースのクライアント向けです。

fastn-mcp --stdio
fastn-mcp --stdio --mode tools                          # Fastn tools only
fastn-mcp --stdio --mode tools --project ID              # Fastn tools + pre-set project
fastn-mcp --stdio --mode tools --project ID --skill ID   # Fastn tools + pre-set project and skill

SSE + Streamable HTTP（リモート）。ウェブベースの AI プラットフォーム向けです。

fastn-mcp --sse --shttp --port 8000

OAuth の設定

リモートトランスポートでは、デフォルトで MCP OAuth 2.1 を使用します。サーバーは RFC 9728 Protected Resource Metadata を実装しています。

fastn-mcp --sse --shttp --port 8000
# OAuth endpoints auto-configured at /.well-known/oauth-protected-resource

OAuth メタデータ用の公開 URL を設定します。

fastn-mcp --sse --shttp --port 8000 --server-url https://mcp.example.com

ローカル開発で OAuth を無効にするには、次のようにします。

fastn-mcp --sse --port 8000 --no-auth

Docker

docker build -t fastn-mcp .
docker run -p 8000:8000 fastn-mcp

docker compose up -d

環境変数

セルフホスト環境でのサーバー設定：

FASTN_MCP_PORT=8000
FASTN_MCP_HOST=0.0.0.0
FASTN_MCP_SERVER_URL=https://your-public-url
FASTN_MCP_TRANSPORT=both
FASTN_MCP_NO_AUTH=false
FASTN_MCP_VERBOSE=false

変数	必須	説明
FASTN_MCP_PORT	いいえ	サーバーのポート（デフォルト：8000）
FASTN_MCP_HOST	いいえ	バインドアドレス（デフォルト：0.0.0.0）
FASTN_MCP_SERVER_URL	いいえ	OAuth メタデータ用の公開 URL
FASTN_MCP_NO_AUTH	いいえ	OAuth を無効にするには true に設定します（開発時のみ）
FASTN_MCP_TRANSPORT	いいえ	トランスポートモード：sse、shttp、both（デフォルト：both）
FASTN_MCP_VERBOSE	いいえ	デバッグログを有効にするには true に設定します

ngrok を使ったローカル開発

ローカルでの開発とテストに限り、ngrok を使用してローカルサーバーを公開します。

# Terminal 1: Start the MCP server
fastn-mcp --shttp --port 8000 --verbose

# Terminal 2: Start ngrok tunnel
ngrok http 8000

OAuth メタデータを解決できるように、ngrok の URL を指定して再起動します。

fastn-mcp --shttp --port 8000 \
  --server-url https://abc123.ngrok-free.dev \
  --verbose

本番環境では、実際のドメインを使い、リバースプロキシの背後に Docker でデプロイしてください。

開発

セットアップ

git clone https://github.com/fastn-ai/fastn-mcp.git
cd fastn-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

テストの実行

pytest tests/ -q

プロジェクト構成

fastn-mcp/
├── fastn_mcp/
│   ├── __init__.py          # Package metadata
│   ├── __main__.py          # CLI entry point
│   ├── server.py            # MCP server, tools, handlers, routing
│   ├── auth.py              # OAuth 2.1 provider (RFC 9728)
│   └── tools/               # Tool utilities
├── tests/
│   ├── test_server.py       # 185+ tests covering all tools and transports
│   └── conftest.py          # Test fixtures
├── Dockerfile               # Production container
├── docker-compose.yml       # Docker Compose for deployment
├── pyproject.toml           # Python project configuration
└── README.md

CLI リファレンス

fastn-mcp [OPTIONS]

Transport:
  --stdio          Use stdio transport (Claude Desktop, Cursor)
  --sse            Enable SSE transport
  --shttp          Enable Streamable HTTP transport

Server:
  --host HOST      Bind address (default: 0.0.0.0)
  --port PORT      Port number (default: 8000)
  --no-auth        Disable OAuth (development only)
  --server-url URL Public URL for OAuth metadata

Mode:
  --mode {agent,tools} Tool mode for stdio: "agent" (all tools) or "tools" (Fastn tools only)
  --project ID     Pre-set project ID for stdio
  --skill ID       Pre-set skill ID for stdio (requires --project)

Debug:
  -v, --verbose    Enable debug logging

対応コネクタ

Fastn は、次のような 250 以上の構築済みコネクタを提供しています。

コミュニケーション： Slack、Microsoft Teams、Discord、Gmail、Outlook、SendGrid、Twilio

プロジェクト管理： Jira、Linear、Asana、Trello、Monday.com、ClickUp、Notion

開発： GitHub、GitLab、Bitbucket、PagerDuty、Sentry、Datadog

CRM・営業： Salesforce、HubSpot、Pipedrive、Zoho CRM

データベース： PostgreSQL、MySQL、MongoDB、Redis、Supabase、Firebase

クラウド： AWS、Google Cloud、Azure、Cloudflare

金融： Stripe、QuickBooks、Xero

その他 200 以上のコネクタについては、fastn.ai/integrations でカタログ全体をご覧ください。

ライセンス

MIT

Links

• Fastn Platform
• Fastn SDK
• MCP Specification
• Documentation