개발자 및 AI 통합

FTIR.fun을 모든 AI 도구 또는 앱에 연결

AI 어시스턴트 또는 자체 코드에 130,000개 이상의 참조 스펙트럼, 지식 그래프 피크 추론, 문헌 기반 해석에 대한 직접 액세스 권한을 부여하세요. 연결 방법은 세 가지 중 하나를 선택하세요 — AI 어시스턴트용 MCP, 코드용 REST API, 또는 노코드 플랫폼용 기성 스킬. 아래의 모든 경로는 처음 사용자를 위해 단계별 지침으로 작성되었습니다.

1. 경로 선택 2. MCP 설정 3. REST API 4. 스킬 및 플러그인 5. AI가 할 수 있는 일 6. 문제 해결

검토 및 등록됨

A Anthropic MCP Registry ✓ S Smithery ✓ M MCP.so ✓ Py PyPI ✓ n8n npm ✓

시작하기 전에 — API 키를 받으세요

MCP와 REST API는 모두 하나의 FTIR.fun API 키를 사용합니다. Coze/Doubao는 플러그인 게시자가 구성한 서비스 키를 사용하므로 최종 사용자는 개인 키를 붙여넣지 않습니다. 개인 키를 얻는 데 약 1분이 소요됩니다:

FTIR.fun에 로그인 계정이 없으면 무료 계정을 만드세요. 새 계정에는 무료 평가판 크레딧이 포함됩니다.
API 키 대시보드 열기 이동 계정 → API 키 그리고 생성을 클릭하십시오.
키를 즉시 복사하여 저장하세요 전체 키(ftir_로 시작)는 한 번만 표시됩니다. 안전한 곳에 보관하세요. 분실하면 새로 생성하면 됩니다.

🔑 준비되었습니까? API 키 대시보드 열기 새 탭에서 연 다음 돌아와서 위에서 선택한 경로를 따르십시오.

⚠️ 호스팅된 MCP 서버는 FTIR.fun API 키 대시보드에서 생성된 계정 API 키(ftir_로 시작)만 허용합니다. 서버 측 마스터 키는 REST 운영자를 위한 것이며 호스팅된 MCP에 로그인할 수 없습니다.

1단계 — 어떤 연결이 적합한가요?

세 가지 모두 동일한 엔진에 연결됩니다: 130,000개 이상의 스펙트럼, 지식 그래프 추론 및 문헌 인용. 하나만 필요합니다. 작업 방식에 따라 선택하세요 — 확실하지 않습니까? MCP는 AI 어시스턴트를 사용하는 모든 사람에게 가장 인기 있는 선택입니다.

MCP경로 A — MCP 서버

MCP(Model Context Protocol)는 AI 어시스턴트가 외부 도구를 호출하는 표준 방식입니다. FTIR.fun은 호스팅된 MCP 서버를 실행합니다. 로컬에서 아무것도 설치하거나 실행하지 않습니다. AI 클라이언트에 작은 구성을 추가하고 API 키를 입력하면 어시스턴트가 7개의 FTIR 도구를 사용할 수 있습니다.

✓ 로그인 작동 방식 (먼저 읽어주세요): FTIR.fun은 계정의 API 키로 인증하며, Authorization: Bearer 헤더로 전송됩니다. OAuth 브라우저 로그인이나 별도의 권한 부여 페이지가 없습니다. 클라이언트가 권한 부여 웹페이지를 열려고 하면 오래된 구성을 사용하고 있는 것입니다 — 아래 문제 해결을 참조하십시오.

정확한 단계를 위해 클라이언트를 선택하세요:

VS Code에서 FTIR.fun MCP 설정

에이전트 모드의 GitHub Copilot Chat이 있는 최신 VS Code가 필요합니다.

프로젝트를 열고 .vscode/mcp.json 파일을 만드세요. 프로젝트 폴더 내에 .vscode 폴더(없는 경우)를 만들고 그 안에 mcp.json 파일을 만드세요. 모든 프로젝트에서 FTIR.fun을 사용할 수 있도록 하시겠습니까? 동일한 JSON을 사용자 수준 설정에 넣으세요. 명령 팔레트를 열고 ＇Preferences: Open User Settings (JSON)＇을 검색한 후 대신 mcp.servers 항목을 추가하세요.

이 정확한 구성을 붙여넣으세요. 그대로 복사하세요. ${input:...} 부분을 실제 키로 바꾸지 마세요. VS Code가 서버 시작 시 안전하게 키를 요청합니다.

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ftirfun-api-key",
      "description": "FTIR.fun API key",
      "password": true
    }
  ],
  "servers": {
    "ftirfun": {
      "type": "http",
      "url": "https://ftir.fun/mcp",
      "headers": {
        "Authorization": "Bearer ${input:ftirfun-api-key}"
      }
    }
  }
}

ftirfun 서버 시작 명령 팔레트를 열고 ＂MCP: List Servers＂를 실행한 후 ftirfun을 선택하고 시작을 선택하세요. 일부 VS Code 버전에서는 mcp.json에서 서버 바로 위에 시작 작업이 표시됩니다. 그것도 작동합니다.
메시지가 표시되면 API 키만 붙여넣으세요. VS Code에서 ftirfun-api-key를 요청하면 원시 키(ftir_로 시작)만 붙여넣으세요. Bearer라는 단어를 입력하지 마세요. — 설정이 자동으로 추가합니다.
연결 확인 에이전트 모드에서 Copilot 채팅을 열고 도구 목록을 확인하세요. FTIR.fun에는 7개의 도구가 표시되어야 합니다. 그런 다음 아래의 테스트 프롬프트를 시도하세요.
```
Use FTIR.fun to explain the FTIR peak at 1715 cm-1.
```

💬 이전에 인증 페이지 또는 ＂인증 페이지가 존재하지 않음＂ 오류를 보셨나요? 그것은 구식 OAuth 스타일 구성이었습니다. 이전 ftirfun 항목을 삭제하고 위의 JSON을 붙여넣은 후 VS Code를 다시 로드하고 다시 시작하세요. 전체 수정 방법은 문제 해결을 참조하세요.

Claude에서 FTIR.fun MCP 설정

Anthropic MCP 레지스트리에 공식 등록되었습니다. Claude Desktop 및 Claude Code에서 작동합니다.

MCP 서버 설정 열기 Claude Desktop에서 설정 → 커넥터 → 사용자 지정 커넥터 추가로 이동합니다. Claude Code에서는 MCP 구성 파일을 편집합니다.
원격 서버 및 Bearer 헤더 추가 호스팅된 URL을 사용하고 API 키를 Authorization 헤더로 추가하세요. 플레이스홀더를 실제 키(ftir_로 시작)로 바꾸세요.
원격 MCP 서버
```
URL: https://ftir.fun/mcp
Header: Authorization: Bearer ftir_your_key_here
```
Claude를 다시 시작하고 확인하세요 Claude Desktop을 다시 시작하고, 커넥터/도구 패널을 열어 FTIR.fun 도구가 나타나는지 확인하세요. 그런 다음 일반 언어로 질문하세요.
```
Identify this polymer from its FTIR peaks: 2915, 1715, 1450 cm-1.
```

📎 Claude Code CLI를 선호하시나요? claude mcp add --transport http ftirfun https://ftir.fun/mcp --header ＂Authorization: Bearer ftir_your_key_here＂를 실행하세요.

Cursor에서 FTIR.fun MCP 설정

Cursor의 MCP 구성을 편집하여 AI 코드 편집기가 IDE를 떠나지 않고 FTIR.fun을 호출할 수 있도록 하세요.

MCP 구성 파일 열기 ~/.cursor/mcp.json(전역) 또는 프로젝트 내 .cursor/mcp.json을 생성하거나 편집하세요.

서버 블록 붙여넣기 플레이스홀더를 실제 키(ftir_로 시작)로 바꾸세요.

~/.cursor/mcp.json

{
  "mcpServers": {
    "ftirfun": {
      "url": "https://ftir.fun/mcp",
      "headers": {
        "Authorization": "Bearer ftir_your_key_here"
      }
    }
  }
}

커서 다시 로드 및 확인 Cursor를 다시 열고 설정 → MCP에서 ftirfun 서버와 녹색 상태를 확인한 후 채팅에서 질문하세요.

Codex 또는 모든 MCP 하네스에서 FTIR.fun MCP 설정

OpenAI Codex 및 원격 HTTP 서버를 지원하는 모든 MCP 호환 클라이언트에서 작동합니다.

Codex 구성에 서버 추가 클라이언트를 호스팅된 URL로 지정하고, API 키를 Bearer 헤더로 보내도록 하세요. 자리 표시자를 실제 키로 바꾸세요.
~/.codex/config.toml
```
[mcp_servers.ftirfun]
url = "https://ftir.fun/mcp"
http_headers = { Authorization = "Bearer ftir_your_key_here" }
```
다시 시작하고 도구가 로드되는지 확인하세요. 클라이언트를 다시 시작하고 프롬프트 전에 7개의 FTIR.fun 도구가 나열되어 있는지 확인하세요.

Gemini CLI에서 FTIR.fun MCP 설정

동일한 호스팅 URL과 Bearer 헤더를 사용하여 MCP 지원 Gemini 클라이언트에 FTIR.fun을 추가하십시오.

~/.gemini/settings.json 편집 API 키 헤더가 포함된 httpUrl 서버 항목을 추가하세요. 플레이스홀더를 실제 키로 바꾸세요.
~/.gemini/settings.json
```
{
  "mcpServers": {
    "ftirfun": {
      "httpUrl": "https://ftir.fun/mcp",
      "headers": {
        "Authorization": "Bearer ftir_your_key_here"
      }
    }
  }
}
```
Gemini CLI 재시작 및 확인 /mcp를 실행하여 서버를 나열하고 프롬프트 전에 ftirfun이 연결되었는지 확인하세요.

🧩 다른 MCP 클라이언트를 사용 중이신가요? 원격 스트리밍 가능 HTTP 서버를 지원하는 모든 클라이언트가 작동합니다: URL을 다음으로 설정하세요. https://ftir.fun/mcp 그리고 보내기 Authorization: Bearer <your key>. 전체 도구 스키마는 공개 서버 카드를 참조하세요: server-card.json

✓ 성공적으로 연결되면 AI 클라이언트는 다음 7가지 도구를 나열해야 합니다. parse_ftir_spectrum, analyze_ftir_spectrum, submit_ftir_report, get_ftir_report_status, explain_peaks, find_spectra, fetch_result. 도구가 적게 표시되거나 전혀 표시되지 않으면 아래 문제 해결을 확인하세요.

API경로 B — REST API

자체 코드에서 Python, JavaScript, R, MATLAB, Java, Go 등 모든 언어로 FTIR.fun을 호출하세요. 알 수 없는 스펙트럼 식별, 피크 설명, 참조 스펙트럼 찾기, 보고서 번호로 이전 결과 가져오기를 위한 표준 HTTP 엔드포인트입니다. LIMS 통합, 배치 파이프라인 또는 자체 앱에 FTIR 검색 추가에 이상적입니다.

REST 서비스가 온라인 상태인지 확인하세요 상태 엔드포인트는 공개이며 포인트를 소모하지 않습니다. 아래 JSON을 반환해야 합니다. HTML 페이지나 시간 초과가 표시되면 서비스가 일시적으로 중단되었을 수 있습니다.
curl
```
curl https://ftir.fun/health
```
예상 응답
```
{"status":"ok","service":"ftirfun-api"}
```
X-API-Key 헤더로 인증 모든 보호된 엔드포인트는 X-API-Key 헤더에 키를 받습니다. 웹 앱과 동일한 계정 규칙이 적용됩니다: 포인트, 구독 및 속도 제한. 키가 잘못되었거나 누락된 경우 401 JSON 오류가 발생합니다.
인증 헤더
```
X-API-Key: ftir_your_key_here
```

첫 번째 호출 — 알 수 없는 스펙트럼 식별 피크 목록(또는 업로드된 파일)을 보내고 유사도 점수와 피크 증거가 포함된 순위별 후보 물질을 받습니다. 옵션 블록은 선택 사항입니다. 기본값은 top_k=15(범위 1-50) 및 tolerance_cm1=8(범위 1-30)입니다.

curl

curl -X POST https://ftir.fun/ftir/analyze_spectrum \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"spectrum":{"type":"ftir","x_unit":"cm-1","y_unit":"absorbance","peaks":[3026,1600,1493,1452,756,697]},"options":{"top_k":5,"tolerance_cm1":8}}'

Python

import requests

resp = requests.post(
    "https://ftir.fun/ftir/analyze_spectrum",
    headers={"X-API-Key": "ftir_your_key_here"},
    json={
        "spectrum": {"type": "ftir", "x_unit": "cm-1", "y_unit": "absorbance",
                     "peaks": [3026, 1600, 1493, 1452, 756, 697]},
        "options": {"top_k": 5, "tolerance_cm1": 8},
    },
)
print(resp.json())

성공 응답 예시 (축약됨)

{
  "success": true,
  "search_mode": "peak_only",
  "n_matches": 5,
  "confidence": 0.42,
  "confidence_source": "peak_match_score",
  "summary": "Peak-based FTIR matching ranks Styrene/acrylonitrile copolymer first...",
  "matches": [
    {"rank": 1, "name": "Styrene/acrylonitrile copolymer", "cas": "9003-54-7",
     "num": 119319, "score": 0.4214, "matched": 6}
  ],
  "evidence": ["3026 cm-1 -> alkyl C-H vibration (DOI 10.5650/jos.ess14201)"],
  "peak_explanations": [
    {"peak_cm1": 3026, "assignment": "alkyl C-H vibration",
     "evidence_type": "kg_peak_group"}
  ],
  "uncertainty": "The leading match is close to the runner-up..."
}

나머지 엔드포인트 살펴보기 전체 참조는 모든 엔드포인트, 요청 및 응답 형식, 오류 코드 및 더 많은 코드 샘플을 다룹니다. 다음을 참조하세요. API 문서.

원하는 것	엔드포인트	입력
알 수 없는 스펙트럼 식별	`POST /ftir/analyze_spectrum`	spectrum.peaks 또는 file_base64가 포함된 JSON 본문
하나 이상의 피크 설명	`POST /ftir/explain_peak_assignments`	피크 목록 또는 쿼리 텍스트가 포함된 JSON 본문
알려진 참조 스펙트럼 찾기	`POST /ftir/find_spectra`	쿼리 문자열이 포함된 JSON 본문
보고서 번호로 이전 결과 가져오기	`GET /ftir/result/{result_num}`	경로 매개변수, 선택사항 ?language_code=en
전체 비동기 보고서를 제출한 후 폴링하세요	`POST /ftir/reports` · `GET /ftir/reports/{task_id}`	file_base64가 포함된 JSON 본문 (필수)
기기 파일을 피크로 파싱합니다.	`POST /parse-spectrum`	멀티파트 파일 업로드 또는 file_base64가 포함된 JSON

주요 매개변수 참조

매개변수	유형	기본값	범위	사용자
`top_k`	int	15	1–50	`analyze_spectrum`
`tolerance_cm1`	int	8	1–30	`analyze_spectrum`
`limit`	int	10	1–20	`find_spectra`
`sampling_mode`	string	(비어 있음)	아래 목록 참조	`reports`, `explain_peaks`
`language_code`	string	"en"	ISO 639-1	`reports`, `fetch_result`
`include_report`	bool	true	—	`get_ftir_report_status`

📘 사용자 정의 GPT를 구축하거나 다른 도구로 가져오시겠습니까? OpenAPI 스키마를 직접 가져오세요: openapi.platform.yaml.

계측기 파일 구문 분석 (두 가지 방법)

/parse-spectrum 엔드포인트는 멀티파트 파일 업로드 또는 base64로 인코딩된 콘텐츠가 포함된 JSON 본문을 허용합니다. 둘 다 동일한 응답(감지된 피크 및 전체 곡선)을 반환합니다.

옵션 A: 멀티파트 파일 업로드

curl -X POST https://ftir.fun/parse-spectrum \
  -H "X-API-Key: ftir_your_key_here" \
  -F "file=@/path/to/sample.spc"

옵션 B: base64가 포함된 JSON

curl -X POST https://ftir.fun/parse-spectrum \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "V2F2ZW51bWJlci...", "filename": "sample.spc"}'

응답

{
  "peaks": [697, 756, 1028, 1452, 1493, 1600, 3026],
  "spectrum": [{"x": 400.0, "y": 0.023}, {"x": 401.0, "y": 0.024}, ...],
  "status": "ok",
  "error": null
}

Skill경로 C — 기술 및 플러그인

인기 있는 AI 및 자동화 플랫폼을 위해 사전 제작된 패키지를 제공하므로 API 호출을 직접 작성할 필요가 없습니다. 패키지를 설치하거나 플러그인을 가져오면 FTIR.fun이 워크플로의 구성 요소가 됩니다. 아래 각 카드에는 실행하거나 가져와야 할 내용이 정확히 나와 있습니다.

LangChain

파이썬 패키지 · PyPI

게시됨

FTIR 인식 에이전트 구축을 위한 드롭인 도구입니다. Base64 인코딩, 재시도 및 비동기 호출을 처리합니다.

설치

pip install langchain-ftirfun

최소 호출

from langchain_ftirfun import explain_peaks

result = explain_peaks(
    api_base_url="https://ftir.fun",
    api_key="ftir_your_key_here",
    peaks=[1715],
)
print(result)

FTIRFUN_TOOLS를 가져와서 목록에 있는 모든 7개 함수를 얻으십시오. 각 함수는 첫 두 인수로 api_base_url과 api_key를 받습니다.

PyPI 페이지

n8n

커뮤니티 노드 · npm

게시됨

시각적 자동화 워크플로우에 FTIR 검색을 드래그 앤 드롭하세요. 코딩 필요 없음 — 노드를 연결하고 실행하세요.

설치

npm install n8n-nodes-ftirfun

또는 n8n에서 추가하세요: 설정 → 커뮤니티 노드 → 설치.

npm 페이지

코즈 / 두바오

OpenAPI 플러그인 · 게시자 서비스 키

라이브

Coze 클라우드 플러그인은 스펙트럼 분석, 참조 라이브러리 검색, 피크 설명의 세 가지 도구와 함께 게시됩니다. 최종 사용자는 API 키를 구성하지 않고도 Doubao에서 직접 사용할 수 있습니다.

엔드포인트

/coze/analyze_spectrum_flat
/coze/find_spectra
/coze/explain_peaks

할당량은 Coze sys_uuid를 통해 사용자별로 추적됩니다. 플러그인은 게시자가 구성한 서비스 키를 사용합니다.

GPT

ChatGPT

Custom GPT · GPT Actions

스키마 준비 완료

스펙트럼을 분석하고 피크를 설명하며 참조 스펙트럼을 찾는 사용자 지정 GPT를 빌드하세요. OpenAPI 스키마를 작업으로 가져오세요. ChatGPT Plus가 필요합니다.

URL 가져오기

https://ftir.fun/openapi.platform.yaml

GPT 편집기에서: 구성 → 작업 → URL에서 가져오기. 인증을 API 키(헤더 X-API-Key)로 설정하세요.

OpenAPI 스키마

Dify

사용자 정의 도구 · OpenAPI

스키마 준비 완료

동일한 OpenAPI 스키마를 가져와 Dify 앱 및 에이전트에 FTIR.fun을 사용자 정의 도구로 추가하세요.

URL 가져오기

https://ftir.fun/openapi.platform.yaml

Dify에서: 도구 → 사용자 정의 도구 생성 → 스키마 가져오기, X-API-Key 헤더 설정.

Google Gemini API

함수 선언 (SDK 통합)

준비

자체 코드에서 Gemini API의 함수 호출 흐름을 통해 FTIR.fun을 호출하려면 미리 만들어진 함수 선언을 사용하세요.

선언은 구문 분석 및 비동기 전체 보고서를 포함한 모든 7개 작업을 다룹니다.

선언 JSON GitHub

AI가 실제로 할 수 있는 일

현재 MCP, REST, n8n 및 LangChain 배포판은 7가지 작업을 제공합니다. 게시된 Coze 플러그인은 세 가지 도구(분석, 찾기, 설명)를 제공하며, 다른 템플릿은 더 작은 선언된 세트를 제공할 수 있습니다. 사용하기 전에 각 플랫폼 카드를 확인하세요. 아래 작업은 동일한 FTIR.fun 서비스를 공유합니다.

작업	MCP 도구	REST 엔드포인트	AI에게 이렇게 말하세요.
장비 파일 읽기	`parse_ftir_spectrum`	`POST /parse-spectrum`	sample.spc를 파싱하고 감지된 피크를 나열합니다.
알 수 없는 스펙트럼 식별	`analyze_ftir_spectrum`	`POST /ftir/analyze_spectrum`	이 스펙트럼이 어떤 폴리머인지 식별하십시오.
전체 삼축 보고서 제출	`submit_ftir_report`	`POST /ftir/reports`	ATR 모드에서 전체 보고서를 위해 sample.spa를 제출하세요.
해당 보고서를 폴링하여 가져오세요	`get_ftir_report_status`	`GET /ftir/reports/{task_id}`	보고서 작업을 확인하고 완료되면 링크를 알려주세요.
피크 설명	`explain_peaks`	`POST /ftir/explain_peak_assignments`	1715 및 1450 cm-1에서의 피크는 무엇을 나타냅니까?
알려진 참조 스펙트럼 찾기	`find_spectra`	`POST /ftir/find_spectra`	폴리스티렌의 기준 스펙트럼을 찾습니다.
이전 결과 다시 열기	`fetch_result`	`GET /ftir/result/{result_num}`	결과 20260528100755416137536을 가져옵니다.

지원되는 파일: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. 유효한 sampling_mode 값은 KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR 및 Others입니다. Transmission은 유효한 값이 아닙니다. 원본 파일 확장자를 유지하여 FTIR.fun이 올바른 파서를 선택하도록 하세요.

find_spectra 응답 예시

find_spectra 응답

{
  "success": true,
  "query": "polystyrene",
  "match_mode": "synonym",
  "match_count": 3,
  "summary": "Found 3 reference spectrum candidates for 'polystyrene'.",
  "results": [
    {"num": 555, "spectrum_number": 555, "name": "PS/PPO",
     "cas": "-", "source_type": "direct_read:spa",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

explain_peaks 응답 예시

explain_peaks 응답

{
  "success": true,
  "search_mode": "peak_explanation",
  "peak_explanations": [
    {"peaks_cm1": [1715, 1450],
     "assignment": "1715 cm-1 suggests C=O stretching (ester or carboxylic acid)...",
     "evidence_type": "llm_general_knowledge"}
  ],
  "summary": "Peak explanation based on general FTIR knowledge..."
}

전체 보고서 가져오기 (비동기)

빠른 스크리닝(analyze_spectrum)은 즉시 반환됩니다. 전체 삼축 보고서는 백그라운드에서 실행되며 일반적으로 30-90초가 소요됩니다. 보고서가 실행되는 동안 다시 제출하지 말고 task_id를 유지하고 폴링하세요.

제출 submit_ftir_report(MCP) 또는 POST /ftir/reports(REST)를 호출하세요. task_id와 예약된 result_num이 반환됩니다. file_base64 필드는 필수이며, 다른 필드(sampling_mode, prior_context, language_code, sample_name, sample_order_no)는 선택 사항입니다.

제출 예시 (REST)

curl -X POST https://ftir.fun/ftir/reports \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "V2F2ZW51bWJlci...", "filename": "sample.spa", "sampling_mode": "ATR", "language_code": "en"}'

응답 제출

{"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}

투표 completed가 true가 될 때까지 5-10초마다 get_ftir_report_status(MCP) 또는 GET /ftir/reports/{task_id}를 호출하세요. 완료 응답에는 report_url, report_view(구조화된 보고서 내용) 및 result_num이 포함됩니다.

폴링 예시

curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"

폴링 응답 (진행 중)

{"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}

폴링 응답 (완료됨)

{"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}

최종 보고서 열기 브라우저에서 전체 URL https://ftir.fun/outputdata/?num={result_num}을 열어 FTIR.fun이 렌더링한 완전한 삼축 결과 페이지를 확인하세요.

⚠️ 대기 중이거나 실행 중인 동안 동일한 보고서를 다시 제출하지 마십시오. task_id를 유지하고 완료되거나 실패할 때까지 계속 폴링하십시오. 중복 제출은 포인트를 낭비합니다.

문제 해결

보이는 것	의미	해야 할 일
클라이언트가 브라우저 인증 페이지를 열거나, 인증 페이지가 존재하지 않는다고 표시합니다.	클라이언트가 오래된 OAuth 스타일 서버 항목을 사용하고 있습니다. FTIR.fun은 OAuth를 사용하지 않으며 API 키만 사용합니다.	기존 ftirfun 서버 항목을 삭제하고, 이 페이지에서 정확한 구성을 붙여넣은 후, 클라이언트를 다시 로드하고 ftirfun을 다시 시작하세요.
`401` (MCP) / `401 invalid_api_key` (REST)	API 키가 없거나, 만료되었거나, 취소되었거나, 잘못 붙여넣어졌습니다.	서버를 다시 시작하고 원시 키(ftir_로 시작)만 붙여넣으십시오. 에서 새 키를 생성하십시오. API 키 대시보드 필요한 경우.
서버가 시작되지만 도구가 나타나지 않습니다.	클라이언트가 카탈로그를 새로 고치지 않았거나 구성이 잘못된 키 이름을 사용하고 있습니다.	VS Code의 경우 mcp.json이 servers(mcpServers가 아님)를 사용하는지 확인하십시오. 그런 다음 ftirfun을 중지하고 시작하거나 창을 다시 로드하십시오.
`403 insufficient_balance`	계정에 해당 분석을 위한 포인트가 충분하지 않습니다.	FTIR.fun에서 잔액 또는 구독을 확인한 후 다시 시도하세요.
`429 rate_limit_exceeded`	REST 분석 및 파싱은 API 키당 분당 60회 요청을 허용합니다. REST 결과 및 보고서 상태 읽기는 별도의 분당 120회 요청 버킷을 사용합니다. MCP는 각 API 키 및 도구에 대해 분당 60회 호출을 허용합니다.	도구에서 보고된 재시도 기간을 기다렸다가 다시 호출하세요.
보고서가 대기 중 또는 실행 중으로 유지됩니다.	전체 보고서는 비동기적으로 실행되며 빠른 스크리닝보다 오래 걸립니다.	동일한 task_id를 유지하고 계속 폴링하세요. 중복 보고서 작업을 생성하지 마세요.
`422` 또는 `missing_input`	요청 본문에 필수 필드가 누락되었거나 형식이 잘못되었습니다. analyze_spectrum의 경우 peaks, query 또는 file_base64 중 하나 이상을 제공해야 합니다.	JSON이 유효하고 Content-Type이 application/json이며 필수 필드가 있는지 확인하세요. 위의 예시 요청을 참조하십시오.
`413 file_too_large`	업로드된 스펙트럼 파일이 크기 제한을 초과했습니다.	더 작은 파일을 내보내거나 spectrum.peaks 필드를 통해 피크 위치만 사용하세요.

구축할 준비가 되셨나요?

전체 REST 참조에는 모든 엔드포인트, 요청 및 응답 형식, 인증, 속도 제한, 오류 코드, MCP 도구 정의 및 Python과 curl의 코드 예제가 포함되어 있습니다.

전체 API 문서 보기 → 맞춤형 통합? 문의하세요