AIfra — temporary static previews
48-hour HTTPS previews of prebuilt static sites and HTML slides. No server builds or backends.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"aifra": {
"command": "npx",
"args": [
"aifra"
]
}
}
}実行可能なパッケージ
0.2.0-beta.2stdioリモートエンドポイント
https://api.aifra.ru/mcpstreamable-httpできること
ツール一覧
ツール(6)
🟢get_deploy_instructions
Explain remote browser-confirmed AIfra publication of ready static files, limits and current terms.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"transport": {
"type": "string",
"const": "streamable-http"
},
"publication": {
"type": "string",
"const": "browser_confirmation_required"
},
"terms_url": {
"type": "string",
"format": "uri"
},
"terms_version": {
"type": "string"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
}
},
"preview_ttl_hours": {
"type": "number",
"const": 48
},
"max_active_per_browser_ip": {
"type": "number",
"const": 3
},
"max_extracted_mib": {
"type": "number",
"const": 50
},
"max_active_mib_per_ip": {
"type": "number",
"const": 150
},
"approval_ttl_seconds": {
"type": "number",
"const": 7200
},
"management": {
"type": "string",
"description": "Private browser-local key; never pass it to MCP."
},
"warning": {
"type": "string"
}
},
"required": [
"transport",
"publication",
"terms_url",
"terms_version",
"inputs",
"preview_ttl_hours",
"max_active_per_browser_ip",
"max_extracted_mib",
"max_active_mib_per_ip",
"approval_ttl_seconds",
"management",
"warning"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟡create_preview(files, archive_base64, accept_terms)
Prepare a new temporary static preview. Supply exactly one of small files or ZIP archive_base64. No backend/build. Requires explicit consent; returns an approval link, not a published URL. User must confirm in their browser.
入力スキーマ
{
"type": "object",
"properties": {
"files": {
"description": "One input choice: 1-500 already-built static files, at most 1 MiB decoded in total. Include index.html at the root and all needed assets. Do not also send archive_base64 or archive. For larger output use a ZIP.",
"minItems": 1,
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"description": "Relative POSIX path inside the ready static output, e.g. index.html or assets/app.js. index.html must be at the root. No absolute paths, traversal, symlinks, archives or executable/server files."
},
"content": {
"type": "string",
"maxLength": 1400000,
"description": "Actual file contents, not a filename, local path or download URL. Use UTF-8 text for HTML/CSS/JS and canonical base64 for binary assets. All files together must decode to at most 1 MiB (1,048,576 bytes). No secrets, personal/payment data or forms."
},
"encoding": {
"description": "Defaults to utf8. Set base64 for binary content; standard padded base64 only, without a data: prefix, whitespace or URL-safe alphabet. The decoded bytes count toward the shared 1 MiB limit.",
"type": "string",
"enum": [
"utf8",
"base64"
]
}
},
"required": [
"path",
"content"
],
"additionalProperties": false
}
},
"archive_base64": {
"description": "One input choice: actual ZIP bytes encoded as canonical standard base64, without data: prefix. At most 50 MiB (52,428,800 bytes) of decoded ZIP and 50 MiB extracted content; at most 25 MiB per file. index.html at root. No nested archives or server code. Do not also send files or archive.",
"type": "string",
"maxLength": 69905068
},
"accept_terms": {
"type": "boolean",
"const": true,
"description": "Set true only after the user explicitly agrees to the current terms and public temporary preview limits. Not inferred from a request to generate a site. Preparation is not publication; the user must also personally confirm the approval URL in their browser within 2 hours."
}
},
"required": [
"accept_terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^rop_[A-Za-z0-9_-]{43}$",
"description": "Prepared operation identifier."
},
"status": {
"type": "string",
"const": "pending"
},
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "AIfra preview identifier; never a management key."
},
"approval_url": {
"type": "string",
"format": "uri",
"description": "Return to the user to open personally. This is not the published preview URL. Never approve it on their behalf."
},
"approval_expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "Preparation expires after 2 hours. The 48-hour preview starts only after confirmation."
},
"message": {
"type": "string",
"description": "Next user action; preparation has not published or deleted anything."
}
},
"required": [
"operation_id",
"status",
"preview_id",
"approval_url",
"approval_expires_at",
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴update_preview(files, archive_base64, accept_terms, preview_id)
Prepare replacement of an existing temporary static preview. Supply exactly one of small files or ZIP archive_base64. No backend/build. Requires explicit consent; returns an approval link, not a published URL. User must confirm in their browser. Requires the browser holding the existing management key; expiry is unchanged.
入力スキーマ
{
"type": "object",
"properties": {
"files": {
"description": "One input choice: 1-500 already-built static files, at most 1 MiB decoded in total. Include index.html at the root and all needed assets. Do not also send archive_base64 or archive. For larger output use a ZIP.",
"minItems": 1,
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"description": "Relative POSIX path inside the ready static output, e.g. index.html or assets/app.js. index.html must be at the root. No absolute paths, traversal, symlinks, archives or executable/server files."
},
"content": {
"type": "string",
"maxLength": 1400000,
"description": "Actual file contents, not a filename, local path or download URL. Use UTF-8 text for HTML/CSS/JS and canonical base64 for binary assets. All files together must decode to at most 1 MiB (1,048,576 bytes). No secrets, personal/payment data or forms."
},
"encoding": {
"description": "Defaults to utf8. Set base64 for binary content; standard padded base64 only, without a data: prefix, whitespace or URL-safe alphabet. The decoded bytes count toward the shared 1 MiB limit.",
"type": "string",
"enum": [
"utf8",
"base64"
]
}
},
"required": [
"path",
"content"
],
"additionalProperties": false
}
},
"archive_base64": {
"description": "One input choice: actual ZIP bytes encoded as canonical standard base64, without data: prefix. At most 50 MiB (52,428,800 bytes) of decoded ZIP and 50 MiB extracted content; at most 25 MiB per file. index.html at root. No nested archives or server code. Do not also send files or archive.",
"type": "string",
"maxLength": 69905068
},
"accept_terms": {
"type": "boolean",
"const": true,
"description": "Set true only after the user explicitly agrees to the current terms and public temporary preview limits. Not inferred from a request to generate a site. Preparation is not publication; the user must also personally confirm the approval URL in their browser within 2 hours."
},
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "Existing preview_id returned by AIfra. Do not invent it or pass a URL, alias, management key or source IP."
}
},
"required": [
"accept_terms",
"preview_id"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^rop_[A-Za-z0-9_-]{43}$",
"description": "Prepared operation identifier."
},
"status": {
"type": "string",
"const": "pending"
},
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "AIfra preview identifier; never a management key."
},
"approval_url": {
"type": "string",
"format": "uri",
"description": "Return to the user to open personally. This is not the published preview URL. Never approve it on their behalf."
},
"approval_expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "Preparation expires after 2 hours. The 48-hour preview starts only after confirmation."
},
"message": {
"type": "string",
"description": "Next user action; preparation has not published or deleted anything."
}
},
"required": [
"operation_id",
"status",
"preview_id",
"approval_url",
"approval_expires_at",
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🔴delete_preview(preview_id, confirm_delete)
Prepare deletion of an existing preview. Does not delete until its owner confirms in the browser holding the management key.
入力スキーマ
{
"type": "object",
"properties": {
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "Existing preview_id returned by AIfra. Do not invent it or pass a URL, alias, management key or source IP."
},
"confirm_delete": {
"type": "boolean",
"const": true,
"description": "Set true only after the owner explicitly asks to delete this preview. The tool only prepares deletion; final confirmation requires the browser holding its management key."
}
},
"required": [
"preview_id",
"confirm_delete"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^rop_[A-Za-z0-9_-]{43}$",
"description": "Prepared operation identifier."
},
"status": {
"type": "string",
"const": "pending"
},
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "AIfra preview identifier; never a management key."
},
"approval_url": {
"type": "string",
"format": "uri",
"description": "Return to the user to open personally. This is not the published preview URL. Never approve it on their behalf."
},
"approval_expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "Preparation expires after 2 hours. The 48-hour preview starts only after confirmation."
},
"message": {
"type": "string",
"description": "Next user action; preparation has not published or deleted anything."
}
},
"required": [
"operation_id",
"status",
"preview_id",
"approval_url",
"approval_expires_at",
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_operation_status(operation_id)
Read whether a prepared operation is pending, complete, failed or uncertain. Returns no file content or management key. Never assume pending means published.
入力スキーマ
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^rop_[A-Za-z0-9_-]{43}$",
"description": "Exact operation_id from a preparation response. Read status after user confirmation or on request. Only complete with a result contains the published URL; pending is not published, uncertain must not be replayed."
}
},
"required": [
"operation_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^rop_[A-Za-z0-9_-]{43}$",
"description": "Prepared operation identifier."
},
"status": {
"type": "string",
"enum": [
"pending",
"complete",
"failed",
"uncertain",
"expired"
],
"description": "Only complete plus result proves completion. Pending requires personal browser confirmation. Uncertain must not be automatically retried. Expired preparation needs a new request and fresh consent."
},
"action": {
"type": "string",
"enum": [
"create",
"update",
"delete"
]
},
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "AIfra preview identifier; never a management key."
},
"viewer_origin": {
"type": "string",
"format": "uri"
},
"named_links_enabled": {
"type": "boolean"
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"bytes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"path",
"bytes"
],
"additionalProperties": false
},
"description": "Untrusted static file manifest for review, not file contents."
},
"approval_expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "Exact UTC timestamp in ISO 8601."
},
"terms_url": {
"type": "string",
"format": "uri"
},
"terms_version": {
"type": "string"
},
"result": {
"description": "Successful receipt: ready contains the real viewer URL and expiry; deleted contains no public URL. No management key.",
"anyOf": [
{
"type": "object",
"properties": {
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "AIfra preview identifier; never a management key."
},
"status": {
"type": "string",
"const": "ready"
},
"url": {
"type": "string",
"format": "uri",
"description": "Public viewer URL; share only after successful browser confirmation."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "Server-enforced expiry, normally 48 hours from publication. Updates never extend it; only the owner can manually set a later date."
},
"ttl_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Remaining seconds at response time, not a new lifetime."
},
"active_slots_for_ip": {
"description": "Aggregate active-slot count, never the source IP.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"active_slots_limit": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"preview_id",
"status",
"url",
"expires_at",
"ttl_seconds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "AIfra preview identifier; never a management key."
},
"status": {
"type": "string",
"const": "deleted"
}
},
"required": [
"preview_id",
"status"
],
"additionalProperties": false
}
]
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
}
},
"required": [
"code"
],
"additionalProperties": false
}
},
"required": [
"operation_id",
"status",
"action",
"preview_id",
"viewer_origin",
"named_links_enabled",
"digest",
"files",
"approval_expires_at",
"terms_url",
"terms_version"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_preview_status(preview_id)
Read current public status, URL and server-enforced expiry of an existing preview. Only the service owner can manually extend expiry; updates never extend it.
入力スキーマ
{
"type": "object",
"properties": {
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "Existing preview_id returned by AIfra. Do not invent it or pass a URL, alias, management key or source IP."
}
},
"required": [
"preview_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"preview_id": {
"type": "string",
"pattern": "^pv_[A-Za-z0-9_-]{24}$",
"description": "AIfra preview identifier; never a management key."
},
"status": {
"type": "string",
"const": "ready"
},
"url": {
"type": "string",
"format": "uri",
"description": "Public viewer URL; share only after successful browser confirmation."
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "Server-enforced expiry, normally 48 hours from publication. Updates never extend it; only the owner can manually set a later date."
},
"ttl_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Remaining seconds at response time, not a new lifetime."
},
"active_slots_for_ip": {
"description": "Aggregate active-slot count, never the source IP.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"active_slots_limit": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"bytes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"files_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"updates_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"preview_id",
"status",
"url",
"expires_at",
"ttl_seconds",
"bytes",
"files_count",
"updates_count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}推奨プロンプト
get_deploy_instructionsget_deploy_instructions記録された呼び出し例
get_preview_status入力パラメータ
{
"preview_id": "example-1"
}出力結果
{
"result": {
"content": [
{
"type": "text",
"text": "MCP error -32602: Input validation error: Invalid arguments for tool get_preview_status: Invalid string: must match pattern /^pv_[A-Za-z0-9_-]{24}$/ at preview_id"
}
],
"isError": true
},
"durationMs": 153
}コミュニティ
エビデンス