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: 手動セットアップ
前提条件
クイックスタート
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
サポート
ご質問、問題、機能リクエストについては、次のサイトをご覧ください。
ライセンス
このプロジェクトは、 LICENSEファイルに含まれる条件に基づいてライセンスされます。