Ikonekta ang mga AI tool sa MCP

Ang Ody ay may built-in na MCP (Model Context Protocol) server sa https://api.ody.co/v1/mcp — idagdag ito sa ChatGPT, Claude, Cursor, o anumang MCP client na may API key, at ang assistant ay makakapamahala ng mga contact, makakapagtrabaho sa iyong mga pag-uusap, makakapaghanap ng mga mensahe, makakapagpadala ng mga text, makakabili ng mga numero ng telepono, makakapagrehistro ng 10DLC texting, makakapaglagay ng outbound AI call, at makakapag-configure ng iyong AI agent sa iyong workspace.

Bago ka magsimula

• Kailangan mo ng API key — tingnan ang Kunin ang iyong Ody API key. Para sa isang assistant na magbabasa lamang, gumawa ng key na may read scopes lamang — ang assistant ay inaalok lamang ng mga tool na pinapayagan ng mga scopes na iyon. Upang mag-eksperimento nang hindi nagpapadala ng totoong text, gumamit ng ody_test_… key — tingnan ang Bumuo nang ligtas gamit ang test mode.
• Kasama ang MCP sa bawat plano, simula sa Starter.

Hakbang-hakbang

1. I-click ang Mga Setting sa sidebar, pagkatapos ay Developer API.

2. Mag-scroll sa card na Kumonekta sa ChatGPT & Claude. Ipinapakita nito ang MCP endpoint — https://api.ody.co/v1/mcp — na may button na Kopyahin, at isang handa nang i-paste na client config.

3. Sa mga setting ng MCP/connector ng iyong AI tool, magdagdag ng server gamit ang config na ito (gamit ang iyong totoong key):

{
  "mcpServers": {
    "ody": {
      "url": "https://api.ody.co/v1/mcp",
      "headers": { "Authorization": "Bearer ody_live_…" }
    }
  }
}

4. Tanungin ang assistant ng isang bagay tulad ng "bigyan mo ako ng buod ng aking Ody workspace" upang kumpirmahin ang koneksyon.

Ano ang kayang gawin ng assistant

Ang MCP server ay naglalantad ng dalawampung tool, bawat isa ay pinaghihigpitan ng parehong scope na ginagamit ng REST endpoint nito:

Tool	Ano ang ginagawa nito	Kinakailangang scope
list_contacts	Ilista o hanapin ang iyong mga contact	contacts:read
create_contact	Magdagdag ng contact	contacts:write
update_contact	I-update ang pangalan, kumpanya, telepono, o email ng isang contact	contacts:write
delete_contact	Permanenteng tanggalin ang isang contact	contacts:write
list_conversations	Ilista ang bukas/tapos na mga pag-uusap	conversations:read
get_conversation	Basahin ang isang buong thread	conversations:read
set_conversation_status	Markahan ang isang pag-uusap bilang bukas o tapos na	conversations:write
search_messages	Hanapin ang mga nilalaman ng mensahe, voicemail transcript, at call notes	conversations:read
workspace_summary	Snapshot: bilang ng contact, bilang ng bukas/tapos na, kabuuang hindi nabasa, 7-araw na volume	conversations:read
wait_for_message	Maghintay (hanggang 25 s) para sa isang bagong papasok na mensahe sa isang pag-uusap	conversations:read
send_message	Magpadala ng SMS (sa isang pag-uusap o isang numero ng telepono)	messages:send
list_numbers	Ilista ang iyong mga numero ng workspace	numbers:read
search_numbers	Hanapin ang mga numero ng telepono na maaari mong bilhin	numbers:manage
buy_number	Bumili ng numero — sinisingil tulad ng isang in-app purchase	numbers:manage
get_messaging_status	Suriin ang status ng pagpaparehistro ng 10DLC texting	numbers:manage
submit_10dlc_registration	I-file ang iyong 10DLC business + campaign (may bayad)	numbers:manage
place_call	Ipagawa sa iyong na-publish na AI agent ang paglalagay ng outbound call	calls:place
get_agent	Basahin ang config at paggamit ng credit ng iyong AI agent	agent:manage
configure_agent	I-update ang config ng agent; ipasa ang publish: true upang mag-live	agent:manage
connect_agent_to_number	I-ruta ang isa sa iyong mga numero sa AI agent	agent:manage

Kung nawawala ang isang scope sa key, hindi lang inaalok ang tool na iyon sa assistant — kaya ang isang read-only key ay gumagawa ng tunay na read-only assistant. Ang lahat ay tumatakbo gamit ang mga pahintulot ng miyembro na gumawa ng key, sa workspace na iyon lamang.

Dalawang bagay na dapat malaman:

• Pinapayagan ng wait_for_message ang isang assistant na magsagawa ng isang live na pag-uusap sa SMS: nagpapadala ito ng text gamit ang send_message, naghihintay ng hanggang 25 segundo para sa tugon, at tumutugon — muling tinatawag ang tool kung mag-timeout ang paghihintay.
• Ang mga tool para sa numero, 10DLC, tawag, at agent ay parehong "Agent Phone" surface tulad ng REST API — parehong billing, parehong patakaran, at maaari kang pumalit sa app anumang oras. Tingnan ang Bumili ng mga numero at magrehistro ng texting sa pamamagitan ng API at Maglagay ng mga AI call at pamahalaan ang Astra sa pamamagitan ng API.

Sa isang test key, ang send_message ay nagtatala ng simulated na mensahe, ang buy_number at place_call ay nagsi-simulate (walang binili o tinawagan), ang pag-publish ng agent ay simulated, at ang submit_10dlc_registration ay nagfa-file sa mock mode — walang bayad, walang pagsumite sa registry.

Mga Kaugnay na Artikulo

• Kunin ang iyong Ody API key
• Bumuo nang ligtas gamit ang test mode
• Pangkalahatang-ideya ng API at authentication