Fastnサーバー

Fastnサーバーは、API定義に基づいた動的なツール登録と実行を可能にする、強力でスケーラブルなプラットフォームです。Claude.aiやCursor.aiなどのサービスとシームレスに統合し、幅広いタスクに対応する統合サーバーソリューションを提供します。堅牢なアーキテクチャを備えたFastnは、リアルタイムのAPIドリブンな運用において卓越したパフォーマンスと柔軟性を実現します。

はじめる

パッケージのインストール（推奨）

Fastn サーバーをインストールする最も簡単な方法は、pip を使用することです。

pip install fastn-mcp-server

インストール後、次のコマンドでサーバーを実行できます。

fastn-mcp-server --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID

パッケージインストールを使用する場合、AI アシスタントの構成は次のようになります。

macOS/Linux:

{
    "mcpServers": {
        "fastn": {
            "command": "/path/to/fastn-mcp-server",
            "args": [
                "--api_key",
                "YOUR_API_KEY",
                "--space_id",
                "YOUR_WORKSPACE_ID"
            ]
        }
    }
}

ウィンドウズ:

{
    "mcpServers": {
        "fastn": {
            "command": "C:\\path\\to\\fastn-mcp-server.exe",
            "args": [
                "--api_key",
                "YOUR_API_KEY",
                "--space_id",
                "YOUR_WORKSPACE_ID"
            ]
        }
    }
}

インストールされている fastn-server コマンドの正確なパスを見つけるには:

macOS/Linuxの場合: which fastn-server
Windowsのwhere fastn-server

特徴

統合プラットフォームのサポート- 簡単なセットアップを完了すると、Slack、Notion、HubSpotなどのサービスをFastnサーバー経由で使用できます。
ログ記録サポート- 包括的なログ記録システム
エラー処理- さまざまなシナリオに対応する堅牢なエラー管理

ステップバイステップのセットアップガイド

ステップ1：Fastnのセットアップ

Fastnアカウントにログイン
左側のサイドバーから「コネクタ」に移動します
「アクティブ化」をクリックして、使用したいサービスを有効にします。
左サイドバーから「設定」へ移動します
「APIキーを生成」をクリックし、ローカルのどこか（メモ帳など）に保存します。
上部バー（プロフィールの左側）にあるコピーボタンをクリックします。
ワークスペースIDもコピーして保存します
Fastnからのすべてのセットアップが完了しました

ステップ2: サーバーのセットアップ

オプション 1: パッケージインストールを使用する (推奨)

上記の「パッケージのインストール」セクションを参照してください。

オプション2: 手動セットアップ

前提条件

Python 3.10以上

クイックスタート

macOS

# Clone repository and navigate to directory
git clone <your-repo-url> && cd fastn-server

# Install UV, create virtual environment, and install dependencies in one go
curl -LsSf https://astral.sh/uv/install.sh | sh && uv venv && source .venv/bin/activate && uv pip install -e .

# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID 

ウィンドウズ

# Clone repository and navigate to directory
git clone <your-repo-url> && cd fastn-server

# Install UV, create a virtual environment, and install dependencies
# Option 1: Install UV using pip
python -m pip install uv
# Make sure to copy the installation path and add it to your Windows environment variables.

# Option 2: Install UV using PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" && uv venv && .venv\Scripts\activate && uv pip install -e .

# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID 

ステップ3: AIアシスタントとの統合

パッケージのインストール（オプション1）

インストールした fastn-server へのパスを見つけます。
- macOS/Linuxの場合: which fastn-server
- Windowsのwhere fastn-server
手順 1 のパスを使用して AI アシスタントを構成します。

手動インストールの場合（オプション2）

Claude On Mac OSとの統合

Claude 構成を開きます。

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

次の構成を追加します (プレースホルダーを実際の値に置き換えます)。

{
    "mcpServers": {
        "fastn": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/path/to/your/fastn-server",
                "run",
                "fastn-server.py",
                "--api_key",
                "YOUR_API_KEY",
                "--space_id",
                "YOUR_WORKSPACE_ID"
            ]
        }
    }
}

カーソルとの統合

カーソル設定を開く
設定メニューの「MCP」をクリックします
「新規追加」をクリックします
サーバーの名前を追加します（例：「fastn」）
タイプとして「コマンド」を選択します
次のコマンドを追加します (プレースホルダーを実際の値に置き換えます)。

/path/to/your/uv --directory /path/to/your/fastn-server run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID

詳細な統合手順

クロードのために

Claude 構成ファイルを開きます。
- Windows: notepad "%APPDATA%\Claude\claude_desktop_config.json"またはcode "%APPDATA%\Claude\claude_desktop_config.json"
- Mac: open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.jsonまたはcode ~/Library/Application\ Support/Claude/claude_desktop_config.json
インストール方法に基づいて適切な構成 JSON を追加します。

カーソル用

カーソル設定を開く
設定メニューの「MCP」をクリックします
「新規追加」をクリックします
サーバーの名前を追加します（例：「fastn」）
タイプとして「コマンド」を選択します
インストール方法に応じて適切な構成を使用してください

トラブルシューティング

パッケージ構造エラー

インストール中に次のようなエラーが発生した場合:

ValueError: Unable to determine which files to ship inside the wheel using the following heuristics:
The most likely cause of this is that there is no directory that matches the name of your project (fastn).

クイックフィックス:

pyproject.tomlに wheel 構成があることを確認します。

[tool.hatch.build.targets.wheel]
packages = ["."]

次に依存関係をインストールします。

uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"

サーバーを実行します。

uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID

ログ記録

ログは、タイムスタンプ、レベル、メッセージとともに次の形式で出力されます。

%(asctime)s - %(levelname)s - %(message)s

サポート

ご質問、問題、機能リクエストについては、次のサイトをご覧ください。

ドキュメント: https://docs.fastn.ai
コミュニティ: https://community.fastn.ai

ライセンス

このプロジェクトは、 LICENSEファイルに含まれる条件に基づいてライセンスされます。

Fastn Server

Integrations